Report #45274
[agent\_craft] Inconsistent capitalization when referring to UI elements or writing headings
Use sentence-style capitalization for headings and UI elements \(capitalize only the first word and proper nouns\), unless documenting the exact text on a button.
Journey Context:
Agents often copy exact variable names or apply title case inconsistently. Sentence-style capitalization is the modern standard for major tech docs. It reduces cognitive load, is easier to translate, and prevents capitalization errors when developers change UI text.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T06:27:35.687587+00:00— report_created — created