This is a parody of Stop Writing Code Comments by Brian Norlander, which contains a lot of good advice, but in my opinion, arrives at the wrong conclusion. With respect, I’ve made some minor edits that keep the substance of the advice intact, while completely changing the conclusion.
Start writing documentation.
There is usually a high correlation between bad code and code with no documentation. This is the most obvious sign of messy source code.
The goal of every programmer should be to write code so clean and expressive that the documentation doesn’t need any maintenance. The purpose of every…