Documentation should be written for AI coding agents to understand and modify software, not only for humans.

Added to korrents 22 Jul 2026 · How quotes work · Something wrong? Tell us

Shared subject first, then similar wording. They may agree or disagree.

• A design proposal should describe the feature as though it already existed — once as a tutorial and once as reference documentation. ARAlice Ryhl20 May 2026documentation
• AI-generated technical documentation is optimized for completing a sentence rather than for being understood by a human reader. VBVicki Boykis12 Aug 2026documentation
• Do not run a personal agent on a cheap or local model: weak models are gullible and easy to prompt-inject. PSPeter Steinberger12 Feb 2026documentation
• Examples in documentation should be compiled and run as tests, so that changing the code breaks the docs instead of quietly outdating them. ARAlice Ryhl20 May 2026documentation
• Good documentation is produced by effort, not by tooling that keeps code and docs together HHHamel Husain18 Jan 2026documentation

See this claim on the map