Skip to content

Rebuild the curriculum page around the wiki setup + challenge flow - #14

Merged
aschokking merged 1 commit into
mainfrom
curriculum-page-wiki-flow
Oct 3, 2026
Merged

aschokking merged 1 commit into
mainfrom
curriculum-page-wiki-flow

Conversation

@aschokking

Copy link
Copy Markdown
Contributor

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

Setup          Onboarding -> Environment Setup -> Java Basics
Challenges     Basic Robot Principles -> Tank Drive -> ... -> Auto-stopping Collector
Reference      Robot Architecture, Mapping Buttons to Commands,
               Git Introduction, Clone with GitHub Desktop
AI Tools       (unchanged)

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:

Page Why
getting-started/environment-setup.md was VSCode-centric; the team standardized on IntelliJ. Now covers fork, clone, and the IntelliJ SDK/Gradle JVM config students actually need
getting-started/java-basics.md wiki version, with the public class Foo() { syntax errors fixed
robot-fundamentals/robot-architecture.md adds the Virtual Subsystems section (the setpoint-lock pattern) and Operator Command Map; the challenges link here, so students were landing on the LLM version
robot-fundamentals/operator-command-map.md used the removed whenPressed/whileHeld API; now onTrue/whileTrue/toggleOnTrue as in current code

New 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.md has no mention of SimulationComponent or MockDevicesModule — the real-vs-mock component swap that XbotEdu's own tests depend on — and providers-factories.md opens at Dagger level with no gentle on-ramp. It also repeats the same invalid public 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, and robot-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:build passes, so no dead internal links. CI from #13 will confirm.

🤖 Generated with Claude Code

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>
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