Skip to content

Manual: parts that follow the three readers - #128

Merged
ptescher merged 1 commit into
masterfrom
manual-layout
Nov 14, 2026
Merged

ptescher merged 1 commit into
masterfrom
manual-layout

Conversation

@ptescher

Copy link
Copy Markdown
Owner

The manual's parts followed the code more than the readers. This reorders outline.txt so that each of the three readers (learn to fly, ground control, Towers) has a part of their own, and renames three sections.

New order

  1. Getting started: Start here, installation, the launcher, controls.
  2. Learn to fly: the simulator, flying with a flight controller, flying a VTOL, setting up the radio, flying with a radio, pylon race and tag (and from the station).
  3. Ground control: the screens of the console, the ground control station, other aircraft, connecting to a real aircraft.
  4. Towers: Towers, then its rules.
  5. Real hardware: the flight computer, a flight with it, watching a real plane.
  6. For developers: flying by plan, making the executor better, the game with ArduPlane drones.
  7. Reference.

Renamed sections

  • Recreation → Pylon race and tag
  • Games with ArduPilot → Pylon race and tag from the station
  • The TX15 on the serial line → A flight with the flight computer

Not merged, on purpose
The two pairs of overlapping sections stay as two sections each, side by side. Each pair has different parents in the suite (one runs in the sim or with no window, the other in the station), and a section's setup comes from its parent, so one section cannot hold both. The new names and a first sentence in each say how they belong together.

Checks

  • expectation check: 0 errors, the same 357 warnings as before.
  • A Pages-style build from site/results and site/screenshots: no stale and no missing pictures, no broken links. The folders did not move, so the page addresses are the same.
  • Next goes through the parts in the order above.
  • cargo test --bin sim001 the_suite_checks_clean passes. No Rust changed.

🤖 Generated with Claude Code

The outline now has a part for each thing a reader comes to do: Learn to fly, Ground
control and Towers. Towers has a part of its own, the developer sections come after Real
hardware, the screens of the console come first in their part, and the real-aircraft page
ends the ground control part. The game with ArduPlane drones is a developer section.

Recreation is now Pylon race and tag, Games with ArduPilot is Pylon race and tag from the
station, and The TX15 on the serial line is A flight with the flight computer. The folders
stay, so the results and the screenshots still attach.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@ptescher
ptescher merged commit 6392247 into master Nov 14, 2026
2 checks 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