Adobe ColdFusion 8 Web Application Construction Kit, Volume 1: Getting Started

Commenting Your Code

The last introductory topic I want to mention is commenting your code. Many books leave this to the very end, but I believe it is so important that I am introducing the concept right here—before you start real coding.

The code you have worked with thus far has been short, simple, and pretty self-explanatory. But as you start building bigger and more complex applications, your code will become more involved and more complex, and comments become vital. Here is why you should comment your code:

• If you make code as self-descriptive as possible, when you revisit it at a later date you’ll remember what you did, and why.

• This is even truer if others have to work on your code. The more detailed and accurate comments are, the easier ...