Migrate the remaining substantive wiki pages - #17
Merged
Merged
Conversation
Closes the last real gaps found in the wiki-vs-docs coverage audit. Curriculum: - challenges/advanced-swerve-challenges.md - the only curriculum challenge still missing from the docs. Ported as-is. - robot-fundamentals/coordinate-conventions.md - the robot and field reference frames, and which direction is positive for each axis. Tooling: - swerve-debugging.md - on-robot bring-up procedure for a swerve drivetrain. Ported with the "[insert year here]" placeholders resolved to "the current season's repository", and the on-blocks safety step promoted to a warning at the top rather than buried at step 4. - update-seriouslycommonlib.md - REWRITTEN rather than ported. The wiki version walked through updating a git submodule, but neither XbotEdu nor TeamXbot2026 has an SCL submodule any more (no .gitmodules, no directory, empty submodule status). SCL is a Maven artifact pinned by SeriouslyCommonLibVersion in build.gradle, so the page now documents bumping that version, plus the -DuseLocalCommonLib=true path for testing unpublished SCL changes. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes the last real gaps from the wiki-vs-docs coverage audit. Four pages, two of which needed more than a copy.
Curriculum
challenges/advanced-swerve-challenges.md— the only curriculum challenge still missing from the docs. The wiki's Home page listed it as the Advanced section; the docs had swerve patterns and an example, but not the exercise. Ported as-is, with its links pointed at the docs equivalents.robot-fundamentals/coordinate-conventions.md— the robot and field reference frames, and which direction is positive for each axis and rotation. Listed under Reference, and linked from the swerve debugging page.Tooling
swerve-debugging.md— the on-robot bring-up procedure. Two changes while porting:TeamXbot[insert year here]in two places; now "the current season's robot repository (for exampleTeamXbot2026)"update-seriouslycommonlib.md— rewritten, not ported. The wiki version walks through updating a git submodule:Neither XbotEdu nor TeamXbot2026 has an SCL submodule any more — no
.gitmodules, noSeriouslyCommonLibdirectory, andgit submodule statusreturns nothing in both. SCL is a published Maven artifact pinned inbuild.gradle:Following the wiki steps today would fail at step 7. The new page documents bumping that version against the Azure Artifacts feed, and the
-DuseLocalCommonLib=truecomposite-build path for testing unpublished SCL changes. It also states plainly that the old submodule instructions are out of date, since they'll still be floating around.Coverage after this
Everything substantive on the wiki is now represented. What's left, deliberately:
xattrquarantine fix, so a Mac student still hits a Gatekeeper wall. Worth a one-line follow-up.Verification
pnpm docs:buildpasses. Re-ran the audit afterwards: all four topics now resolve to docs pages.🤖 Generated with Claude Code