How to Document Wisely, by Robert L. Read
Writing good documentation is, first of all, good writing.
…
…write self-explanatory code and only document code in the places that you cannot make it clear by writing the code itself.
Excerpt from How to be a Programmer.


FreeBSD
Hacker News