Th best code comment story was told by Joe Armstrong " Robert Virding, who developed Erlang with me, was famed for his comment. Singular. The entire stuff he wrote had one comment: in the middle of the pattern-match compiler there was a single line saying ‘and now for the tricky bit".