Good documentation is produced by effort, not by tooling that keeps code and docs together

Added to korrents 18 Jan 2026 · How quotes work · Something wrong? Tell us

Related korrents

Our reading — they may agree, disagree or merely touch the same thing.

• When two expert users argue over whether documentation is clear, that debate is unproductive — the way to actually find unclear documentation is to test it on real readers, not to have experts argue about wording. JEJulia Evans8 Jan 2026documentation
  Interesting
• A sense of achievement in software survives writing almost none of the code yourself. DHDavid Heinemeier Hansson26 Aug 2026similar wording
  Interesting
• Code and files generated by tools are pollution: hand-writing them is worth the effort because the bloat slows everything down for everyone. DSDerek Sivers15 Oct 2019similar wording
  Interesting
• Work produced by one frontier model should be reviewed by a different one, for the same reason a good programmer's work improves under a good peer's review. DHDavid Heinemeier Hansson26 Aug 2026similar wording
  Interesting
• Careful step-by-step thinking is a property of the developer, not something a tool or framework can enforce HHHamel Husain18 Jan 2026similar wording
  Interesting

See this on the map →