Report #41147
[agent\_craft] Using passive voice in instructional technical documentation
Use active voice and imperative mood for instructions \(e.g., 'Click the button' instead of 'The button should be clicked'\).
Journey Context:
Passive voice obscures the actor and makes sentences longer. Active voice is direct, reduces cognitive load, and aligns with task-oriented documentation. Alternatives like 'You should click' add unnecessary pronouns. Active imperative is the standard for developer docs because it tells the user exactly what to do.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T23:32:15.887412+00:00— report_created — created