Rebuild the curriculum page around the wiki setup + challenge flow - #14
Merged
Merged
Conversation
The pre-existing curriculum pages were LLM-written and out of sequence with the challenges we just ported. Short-term fix: make the curriculum page the setup-then-challenges flow the wiki actually teaches, and replace the overlapping pages with the wiki versions, which were just reviewed against current XbotEdu and SeriouslyCommonLib code. Ported from the wiki (wiki content wins on overlap): - onboarding.md (new) - accounts and software install - environment-setup.md - fork, clone, IntelliJ + JDK config (was VSCode-centric) - java-basics.md - the Java floor needed to start - git-introduction.md (new), clone-with-github-desktop.md (new) - robot-fundamentals/robot-architecture.md - adds Virtual Subsystems and the Operator Command Map sections; the challenges link here - robot-fundamentals/operator-command-map.md - onTrue/whileTrue instead of the removed whenPressed API Curriculum page and sidebar are now Setup -> Challenges -> Reference -> AI Tools. The three DI/Factory steps in the wiki sequence point at the deeper core-programming/patterns pages rather than duplicating them. Pages left in place but unlisted, pending the larger refactor: oop-concepts, intermediate-java, git-github, and the remaining robot-fundamentals pages. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This was referenced Oct 3, 2026
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.
Short-term fix for the curriculum page: make it the setup-then-challenges flow the wiki actually teaches, instead of the LLM-written module list that was out of sequence with the challenges ported in #12.
The page is now
Sidebar matches. This is the wiki's own ordering, including Making a Pull Request landing mid-sequence rather than at the end.
Pages replaced with wiki versions
Wiki content wins on overlap. These were reviewed against current XbotEdu/SeriouslyCommonLib code before the migration, so they name classes and paths that actually exist:
getting-started/environment-setup.mdgetting-started/java-basics.mdpublic class Foo() {syntax errors fixedrobot-fundamentals/robot-architecture.mdrobot-fundamentals/operator-command-map.mdwhenPressed/whileHeldAPI; nowonTrue/whileTrue/toggleOnTrueas in current codeNew pages:
onboarding.md,git-introduction.md,clone-with-github-desktop.md.DI and Factories
The wiki sequence puts Factories, The Power of Injection, and DI with Dagger between Command Groups and the SCL upgrade. Rather than duplicate them, those steps link to the existing
core-programming/patterns/pages.Follow-up needed before this is really done: those pages don't fully cover what the wiki lessons teach.
dependency-injection.mdhas no mention ofSimulationComponentorMockDevicesModule— the real-vs-mock component swap that XbotEdu's own tests depend on — andproviders-factories.mdopens at Dagger level with no gentle on-ramp. It also repeats the same invalidpublic class ShooterSubsystem() {syntax. I'll send a separate PR strengthening both.Unlisted, not deleted
Left on disk and reachable by URL, pending the bigger refactor:
oop-concepts,intermediate-java,git-github, androbot-fundamentals/{electrical-contract,motor-control,pid-logic,command-based}.Heads up on size
This is a net −554 lines. The wiki pages are leaner than the LLM ones (environment-setup 291→72, java-basics 433→236, operator-command-map 303→85). The LLM pages had more examples, quizzes and expandable asides; what they said was often wrong. Worth mining them for exercises during the refactor rather than treating this as the final shape.
Verification
pnpm docs:buildpasses, so no dead internal links. CI from #13 will confirm.🤖 Generated with Claude Code