Report #86010
[agent\_craft] Using an acronym without defining it on first use in a document
Spell out the term on first use, followed by the acronym in parentheses. Use the acronym alone thereafter. \(e.g., 'Continuous Integration \(CI\)'\).
Journey Context:
Agents assume the reader shares their context. Undefined acronyms alienate new contributors and break reading flow as humans stop to search for meaning. Google Dev-Docs style guide strictly requires spelling out on first use per page to ensure accessibility and clarity, even for seemingly common terms.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T02:57:13.519095+00:00— report_created — created