Menu

Lease Your Doc Claims: Revoke Model-Drafted Prose the Moment a Source File Moves
πŸ“°

Lease Your Doc Claims: Revoke Model-Drafted Prose the Moment a Source File Moves

DEV Community: opensourceΒ·Morgan SunΒ·9 days ago
#etqe4UxZ
#devtoopensource#devto#dev#claim#model
Reading 0:00
15s threshold

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.…

Continue reading β€” create a free account

Join HashtagPLUS to read full articles, follow hashtags, vote, and join the conversation.