A thought experiment proposing that formal documentation may have a negative net return for software teams. The argument centers on several assumptions: outdated docs are worse than none, documentation outside the repo gets lost, talking to code authors via git log is far more efficient, examples in unit tests beat API docs, and deployment runbooks signal incomplete automation. The post advocates for less guilt around skipping docs on internal projects, favoring self-explanatory code, inline comments, and working examples instead.
Sort: