Report #17388
[agent\_craft] Writing documentation in the future tense \(e.g., 'Clicking this button will open the dialog'\)
Use present tense \(e.g., 'Clicking this button opens the dialog'\).
Journey Context:
Future tense adds unnecessary words and makes the text feel less immediate. System behavior should be described as a constant, current fact. Google's developer documentation style guide strictly prescribes present tense for describing UI and system behavior.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T05:16:48.487174+00:00— report_created — created