Skip to content

Manual: fixes from the new-user audit - #126

Merged
ptescher merged 1 commit into
masterfrom
manual-new-user-fixes
Nov 13, 2026
Merged

ptescher merged 1 commit into
masterfrom
manual-new-user-fixes

Conversation

@ptescher

Copy link
Copy Markdown
Owner

An audit of the published manual as three new users (practise flying, ground control with a real aircraft, Towers) found blockers in the first pages of each path. This fixes the ones that are wording or missing pages. All edits are prose, so the packed results and screenshots still attach (a Pages-style build shows no stale or missing pictures).

Front door

  • The landing page names all three uses, links each path, and offers the download before the source build. The comment on cargo run --release now says it starts the launcher.

Flying

  • Your first hover says what the keyboard throttle does in a hover (0 holds, 1 to 5 climb, QRTL brings it down).
  • The sim and VTOL setup text gives the launcher buttons, and says where the Seeker 3 is.
  • Learning with self-levelling says that ANGLE needs Direct control (J).
  • The launcher setup no longer asks for "no controls.cfg yet".

Ground control

  • New page: Connecting to a real aircraft (--connect, --origin, MAVProxy for serial radios, plan in the sim and fly at the field).
  • The ground control path starts the station directly. Picking what to launch says it is not needed for that, and warns about ray tracing.
  • Mission files says where mission.wpl is. The command-line page gains --connect, --origin, --aircraft seeker3 and SIM001_MISSION_FILE.
  • The station setup text is shorter, and the VTOL pages no longer say "Wait until ARM" twice.

Towers

  • The centre tower gives one and a half points, as the rules and the code say (the intro said two).
  • The [[The battlefield|battlefield]] link is fixed.
  • The path starts a practice game directly, mentions the load time, and marks the source-only step.
  • Controls lists the keys of the commander app.

Not fixed here (generator)

Checks

  • expectation check: 0 errors. 8 more launch-in-step warnings, from the launcher and command text added to two setup phrases (the station and Towers phrases already have the same).
  • cargo test --bin sim001 the_suite_checks_clean passes. No Rust changed.

🤖 Generated with Claude Code

The landing page names the three things you can do. Start here gives the launcher
buttons for each path, and the ground control path no longer starts with ray tracing
and Direct control. A new page tells how to connect the console to a real aircraft.
The hover tutorial says what the keyboard throttle does. Towers: the centre tower
gives one and a half points, a broken link is gone, and Controls lists the keys of
the commander app.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@ptescher
ptescher merged commit 171d542 into master Nov 13, 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