Web Programming with HTML5, CSS, and JavaScript

2.3 Comments

As a programmer in the real world, you’ll spend lots of time looking at and editing other people’s code. And, other people will spend lots of time looking at and editing your code. Therefore, everyone’s code needs to be understandable. One key to understanding is good comments. Comments are words that humans read but the computer skips. More specifically, for web programming, the browser engine skips HTML comments. The browser engine is the software inside a web browser that reads a web page’s content (e.g., HTML code, image files) and formatting information (CSS), and then displays the formatted content on the screen.

Usually, HTML code is fairly easy to understand, so there is no need for extensive comments. However, sometimes ...