korrents

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

On the map

5 connected korrents · 4 moments on record from 15 Oct 2019 to 26 Aug 2026.

Same subjectSame subjectSame subjectSame subjectSame subject Good documentation isproduced by effort, not bytooling that keeps code and… HH Hamel Husain — holds since 2026-01-18 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. When two expert usersargue over whether… JE Julia Evans — holds since 2026-01-08 A sense of achievement in software survives writing almost none of the code yourself. A sense of achievementin software survives… DH David Heinemeier Hansson — holds since 2026-08-26 Code and files generated by tools are pollution: hand-writing them is worth the effort because the bloat slows everything down for everyone. Code and filesgenerated by tools are… DS Derek Sivers — holds since 2019-10-15 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. Work produced by onefrontier model should… DH David Heinemeier Hansson — holds since 2026-08-26 Careful step-by-step thinking is a property of the developer, not something a tool or framework can enforce Careful step-by-stepthinking is a property… HH Hamel Husain — holds since 2026-01-18
same subject