The point is that writing comments isn&#x27;t a substitute for writing clear code. I have seen way too much code that someone puked up without thinking about readability, and then tried to save it by sprinkling it with comments.<p>So the first thought when writing code that isn&#x27;t obvious  should not be to comment it, but to figure out if there is a way to write it clearer.<p>But of course, sometimes we need to write code that isn&#x27;t obvious, and then a few well thought through comments will save the day.