Lessons from documenting source code

@dolftax on Twitter

"A common fallacy is to assume authors of incomprehensible code will somehow be able to express themselves lucidly and clearly in comments."

                             - @KevlinHenney