Repository navigation
Lesson 7: number exercises in page order, and give each one the information it needs - #20
Merged
Merged
Conversation
Link the interactive Learn Git Branching tutorial in the Getting Started section and the Additional Resources list so students can practice Git commands hands-on. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
A tutorial page that goes through the RobotPy code from Robot-2024-Public, Robot-2025-Public and Robot-2026 (tracking-hub), file by file: robot.py and CoroutineRobot, subsystems, Phoenix 6, const.py, wpimath geometry and control, the OI bindings, commandify coroutines, autos and command groups, the dashboard, and the Python features the code uses. practice/robotpy is a set of eight exercises with pytest checks that run against the real RobotPy 2026 libraries, plus a small practice robot that runs with "robotpy sim" and "robotpy test". tools/validate-robotpy-practice.py checks that each starter fails and each solution passes. Behaviors checked with RobotPy 2026 while writing this: - whenHeld with a plain function runs one time; a generator runs each loop - a command in two groups raises IllegalCommandUse - calling a commandify command gives a broken command (TypeError when run) - periodic() runs while disabled - CoroutineRobot stores robotInit on the instance, which hides the hook that "robotpy test" uses, so robot tests time out. The practice pack copy of wpilibextra makes these class methods. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
…rward Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
The lesson 7 exercises now use the same in-page Python exercise widget as lessons 1 to 6, instead of a local pytest practice pack. The real RobotPy libraries cannot load in Pyodide, so assets/py/robotpy is a small plain-Python copy of the parts our code uses: wpilib, wpimath, commands2 and phoenix6, plus an exact copy of wpilibextra from Robot-2026 and a cz_sim helper for the checks. An exercise with `library: robotpy` loads it before the student's code, and the worker imports it fresh for every run. - python-worker.js: download a library manifest once, write the files into Pyodide, and forget the modules before each run - python-exercise.html / .js: pass the library URL to the worker - _config.yml: include __init__.py and _sim.py, which Jekyll leaves out - 10 exercises in _data/exercises/py7_*.yml (one Try it block) - validate-exercises.py: understands `library:`, and treats Try it blocks (no tests, no solution) as code that only has to run - validate-robotpy-browser.py: runs every lesson 7 check with the browser copy and with the real RobotPy 2026; both must agree - e2e test for the lesson 7 page - the local practice pack (practice/robotpy) and its tools are removed Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
The exercises were numbered in the order they were written, so the page showed Exercise 3, then 2, then 1, then 7, 4, 5, 6, 8 and R. They are now 1 to 9 from the top of the page, and the part labels inside each exercise (1.1, 2.1, ... 9.3) match. The robot exercise is now Exercise 9 instead of R. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
…no changes) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
A student could not write periodic() in the hopper exercise: the prompt said "runs at JAM_SPEED" but never said to call self.set_speed(), never said where the flags come from, and showed no example. The other exercises had the same kind of gap: a call, a constructor, or a flag the student had to guess. Each prompt now has a "What you need" list with the exact calls, the flags that the stand-in robot has and their start values, and the parts as plain steps. The hopper prompt also shows the same if/elif/else shape from periodic() in intake.py. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
- 3.3: the check now accepts any form of the flipped heading (210 or -150 degrees), and the prompt names rotateBy and explains the -150 - 3.3 and 3.4: say that rotateBy, + and - return a new object, so the result must be saved - 5.4: say that the += 2 goes before the yield, and give that mistake its own failure message instead of the plain-function one - 8.3: point to the "Pick the auto" section, which the student can see, instead of hopper.py - the page says which library parts the browser copy does not have Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
MBimrose
pushed a commit
that referenced
this pull request
Nov 16, 2026
…no changes) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019dqu5om52cZsRn7kinP82t
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.
Summary
Two fixes to Python lesson 7 (
docs/Code/Python Tutorials/07 robotpy in our code.md) and its exercises (_data/exercises/py7_*.yml).Exercise numbers follow the page
The exercises were numbered in the order they were written, so the page showed Exercise 3, then 2, 1, 7, 4, 5, 6, 8 and R. They are now 1 to 9 from the top. The part labels inside each exercise (1.1 … 9.3), the links table, and the page's references to "exercise N" all match. The robot exercise is now Exercise 9 instead of R.
Each exercise says what the student needs
A student could not write
periodic()in the hopper exercise. The prompt said "runs atJAM_SPEED" but never said to callself.set_speed(), never said where the flags come from, and gave no example. Every prompt now has:The hopper prompt also shows the same
if/elif/elseshape fromperiodic()inintake.py.An independent review then worked each exercise as a beginner and compared the prompts with the checks. It found four more problems:
rotateBy,+and-return a new object.+= 2goes beforeyield, and that mistake has its own failure message.hopper.py.The page also says which library parts the browser copy does not have.
Checks
python3 tools/validate-exercises.py: every lesson 7 exercise is ok. The 2 problems it reports are older, inpy5_independent_intakesandpy6_intake_callbacks.python3 tools/validate-robotpy-browser.py --robotpy …: the browser copy and the real RobotPy 2026 agree on every check. The new 3.3 and 5.4 behavior was also run against both.node tools/check-ste.js: no hard findings on the lesson page.Generated by Claude Code