Document fixed wing control smoothing and course lock on level (INAV 10.0)

[b14ckyy]

User documentation for two fixed wing navigation behaviours that changed in INAV 10.0 with iNavFlight/inav#11804 (merged into maintenance-10.x).

New page

docs/06-advanced-features/fixed-wing-control-smoothing.mdx

• What nav_fw_control_smoothness does now: the roll axis uses a triggered S-curve (value × 100 ms, max 900 ms) that only shapes the start of a manoeuvre and adds no lag in steady tracking; pitch keeps its low-pass filter as before
• Typical triggers, a value table by airframe type, in-flight adjustment and the CTL S OSD element
• Upgrade note for users who carried a high value over from 9.x
• nav_cruise_lock_on_level: COURSE HOLD / CRUISE locks the course only once the plane has rolled out below 10° of bank, the three lock paths, the 2.5 s fallback and the OFF legacy behaviour

Cross-links

• flight-modes-navigation.mdx: settings table row, waypoint tuning bullet, new paragraph in the fixed wing COURSE HOLD section
• navigation-pid-tuning-fw.mdx: link from the heading_hold_rate_limit note

All statements were checked against the firmware source on maintenance-10.x.

Note

The page links to fixed-wing-waypoint-turns.mdx, which comes with the separate coordinated-turns docs PR (for iNavFlight/inav#11812). Until that one is merged the link resolves to nothing; the build only warns on it.

🤖 Generated with Claude Code

[qodo-free-for-open-source-projects]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Tip of the day

💡 Did you know, you can enable the Remediation agent and Qodo fixes findings in a dedicated fix PR

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

[qodo-free-for-open-source-projects]

PR Summary by Qodo

Document INAV 10.0 fixed-wing smoothing and course lock

📝 Documentation 🕐 10-20 Minutes

AI Description

• Documents INAV 10.0 triggered roll smoothing while clarifying unchanged pitch filtering.
• Explains level-triggered course locking, fallback timing, legacy behavior, and tuning guidance.
• Cross-links navigation modes and fixed-wing PID tuning to the new guide.

Diagram

graph TD
  A["Flight Modes"] --> B["Smoothing Guide"] --> C["Firmware Settings"]
  D["PID Tuning"] --> B
  B --> E["Waypoint Turns"]

Loading

High-Level Assessment

The dedicated guide with targeted cross-links is the best approach because the behavior spans navigation modes, waypoint handling, tuning, and upgrade guidance. Expanding only the existing flight-mode or PID pages would duplicate details and make the firmware-version change harder to discover; the temporary waypoint-turn link warning should disappear when its companion documentation lands.

Files changed (3) +104 / -3

Documentation (3) +104 / -3

flight-modes-navigation.mdxCross-link fixed-wing navigation behavior to the new guide +5/-2

Cross-link fixed-wing navigation behavior to the new guide

• Reframes control smoothness for INAV 10.0 as manoeuvre-entry shaping without steady-flight lag. Adds COURSE HOLD level-lock behavior and links waypoint tuning guidance to the dedicated page.

docs/05-core-features/flight-modes-navigation.mdx

fixed-wing-control-smoothing.mdxAdd fixed-wing control smoothing and course-lock guide +98/-0

Add fixed-wing control smoothing and course-lock guide

• Documents triggered roll S-curves, unchanged pitch filtering, trigger conditions, value selection, in-flight adjustment, and upgrade advice. It also explains level-triggered COURSE HOLD and CRUISE locking, the 10° threshold, 2.5-second fallback, and legacy behavior.

docs/06-advanced-features/fixed-wing-control-smoothing.mdx

navigation-pid-tuning-fw.mdxLink PID tuning guidance to control smoothing documentation +1/-1

Link PID tuning guidance to control smoothing documentation

• Turns the control-smoothness reference in heading-hold tuning guidance into a link to the new detailed guide.

docs/07-pid-tuning/navigation-pid-tuning-fw.mdx