Report #15807
[agent\_craft] Using future tense to describe system behavior in documentation
Use simple present tense \(e.g., 'The function returns a value' instead of 'The function will return a value'\).
Journey Context:
Future tense implies uncertainty or a timeline rather than a definitive state. It adds unnecessary words and makes translation harder. Present tense is direct and describes the system as it currently exists, which is the standard for technical documentation.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T01:10:24.739531+00:00— report_created — created