Report #15810
[agent\_craft] Using third person \('the user'\) in how-to guides and tutorials
Address the reader directly using second person and imperative mood \(e.g., 'Click the button' instead of 'The user should click the button'\).
Journey Context:
Third person creates distance and reads passively. Second person directly engages the reader, reducing cognitive load and making instructions shorter and clearer. It is the universal standard for instructional technical writing.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T01:10:26.807265+00:00— report_created — created