Throughout this book, we encourage you to comment your code as much as possible. Any code, ColdFusion or otherwise, is a hundred times more valuable if it is thoroughly commented. And it becomes a thousand times more valuable if all the code for an application is commented in a consistent style.
You should decide ahead of time how you will comment your code, and stick to it while you work. For instance, you might make resolutions like these:
Each .cfm file should have a header comment that lists the purpose of the file, when it was first written, and the original author’s name.
When anyone makes a significant change to the file, the header comment should be amended, explaining which portions were added or changed. Over time, ...