Code should read like a diary

Code should read like a diary. When someone you’ve never met picks it up and starts reading, what you wrote is all that person will ever know for sure. If you leave out intimate details, those details are lost forever.