Note

To include comments in a JavaScript script, put // at the beginning of each comment line. (No closing tag is needed for JavaScript comments.) In style sheets, start comments with /* and end them with */.

The HTML <!-- and --> tags will not work properly in scripts or style sheets!

You can and should, however, include one <!-- tag just after a <script> or <style> tag, with a --> tag just before the matching </script> or </style>. This hides the script or style commands from older browsers that would otherwise treat them as regular text and display them on the page.

To Do

It will be well worth your time now to go through all the Web pages, scripts, and style sheets you've created so far and add any comments that you or others might find helpful when revising them in the future.

1. Put a comment explaining any fancy formatting or layout techniques before the tags that make it happen.
2. Use a comment just before an <img /> tag to briefly describe any important graphic whose function isn't obvious from the alt message.
3. Always use a comment (or several comments) to summarize how the cells of a <table> are supposed to fit together visually.
4. If you use hexadecimal color codes (such as <font color="#8040b0"> or <span style="color: #8040b0">), insert a comment indicating what the color actually is (bluish-purple).
5. Indenting your comments helps them stand out and makes both the comments and the HTML easier to read. Don't forget to use indentation in the HTML itself to make it more readable, too.