Skip to content

Migrate the remaining substantive wiki pages - #17

Merged
aschokking merged 1 commit into
mainfrom
migrate-remaining-wiki-pages
Oct 3, 2026
Merged

aschokking merged 1 commit into
mainfrom
migrate-remaining-wiki-pages

Conversation

@aschokking

Copy link
Copy Markdown
Contributor

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:

  • the wiki text said TeamXbot[insert year here] in two places; now "the current season's robot repository (for example TeamXbot2026)"
  • "put the robot ON BLOCKS" was step 4 of 9. A miswired swerve module can drive at full power in an unexpected direction, so that's now a warning callout before step 1.

update-seriouslycommonlib.md — rewritten, not ported. The wiki version walks through updating a git submodule:

7. Type in "cd SeriouslyCommonLib"
8. Type in "git checkout main"
...
12. If it shows "modified: SeriouslyCommonLib (new commits)" ...

Neither XbotEdu nor TeamXbot2026 has an SCL submodule any more — no .gitmodules, no SeriouslyCommonLib directory, and git submodule status returns nothing in both. SCL is a published Maven artifact pinned in build.gradle:

def SeriouslyCommonLibVersion = '20260405.5'

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=true composite-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:

Wiki page Why not
QDriverStation for Macs docs has its own version — but it's missing the xattr quarantine fix, so a Mac student still hits a Gatekeeper wall. Worth a one-line follow-up.
RoboRIO docs links out to the wiki; addresses already appear in the real-robot challenge
Programming Onboarding in-season onboarding, not curriculum; docs links out
App development App team / React — different discipline
Java Test Runner Output Log obsolete; VS Code was removed from onboarding
Use SmartGit to clone obsolete; tool no longer used

Verification

pnpm docs:build passes. Re-ran the audit afterwards: all four topics now resolve to docs pages.

🤖 Generated with Claude Code

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>
@aschokking
aschokking merged commit b52b82e into main Oct 3, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant