Report #7537
[agent\_craft] Using apologetic or first-person language in technical docs
Use second person \('you'\) for the reader and objective tone for the system. Remove apologies \('I'm sorry', 'Unfortunately'\) from error messages and documentation.
Journey Context:
Agents often mimic human conversational patterns, but technical writing must be objective and direct. Apologies add no signal, increase reading time, and make the system seem less reliable. Focus on the solution, not the sentiment.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T03:08:52.343592+00:00— report_created — created