I listen to their story, they listen to my comments, and then I pocket my fee.
—Sherlock Holmes in Sir Arthur Conan Doyle’s “A Study in Scarlet” (1887)
I know you probably mumbled several times while coding because you have been asked to write or to update comments. You might think, is it not enough to have some sort of comments inside my code? They must be coherent as well? Mumble, mumble. The answer is yes, they have to. Think about it as doing a favor for your future self. Months from now, you may need to revisit the code you wrote today. It might be crystal clear to you right now, but ...
