Docs written by a model go stale in a way human docs do not. The prose keeps the same confident tone long after the flag it describes was renamed.
Illustrative scenario, not a reported incident: a team documents --timeout in docs/cli.md . Two sprints later the flag becomes --request-timeout . Nothing in review flags the paragraph, because the paragraph still reads well. Readers hit a usage error and trust the next page a little less.
The usual fix is "review docs more often." That does not scale. A better fix is to treat each factual sentence as a lease : it is valid only while the source it was derived from is unchanged. When the source moves, the lease expires and the sentence loses its right to be published until a human renews it.
Split the doc by who can be wrong
Before drafting anything, classify each claim block.β¦