7/20/2026 at 7:56:51 PM
I use AI to write documentation frequently. An AI agent, 600k tokens into a feature that it just authored, understands the feature as well or better than I do. It can document, compactly, what the code actually does, as well as the intent. These docs add value above having no docs and letting another AI, with zero context, read your bare code.In the context in which I work, the quality of these docs is sufficient.
Unless your docs are being read by thousands of people, in 2026, in most contexts, handwriting docs adds less value than writing high quality instructions to your agent.
There are exceptions. For example, when kicking off a project, short crisp prose in a product brief aligns a team, removes uncertainty, and clarifies decisions. These are worth hand writing.
by owentbrown
7/20/2026 at 8:16:47 PM
An AI agent, 600k tokens into a feature that it just authored, understands the feature as well or better than I do.
On this, we are in complete agreement.
by fwlr
7/20/2026 at 11:51:02 PM
I don't know about that. There's no understanding anywhere at that point.by horticulturist
7/21/2026 at 4:00:09 AM
> handwriting docs adds less value than writing high quality instructions to your agentAre the instructions not docs?
by nlawalker