When to add comments is a judgement call. Keep in mind that you are commenting not only for other developers, but also for yourself. You may be asked to modify code a year later, and, believe me, you will have wished you added more comments. Never add a comment for something obvious. For example, don't add a comment like this: . Any developer would see an H1 tag and and would know that an is the title for the page. However, say your design requires a span tag around the company name, like this: . You may wonder a year later why you added the span tags, and a comment may help you remember and will help the next developer who expands on your code.