by kirupa | 8 January 2015
Everything you write in your code editor might seem like it is intended for your browser's eyes only:
This is a companion discussion topic for the original entry at http://www.kirupa.com/html5/comments.htm
This is a companion discussion topic for the original entry at http://www.kirupa.com/html5/comments.htm
Honestly, if you do this you’ll be a hero to all developers who follow. Not only that though as your personal projects grow you’ll be thanking yourself for carefully annotating what everything does, it gets mad confusing.
The challenge I see with older projects is that the comments are no longer up-to-date. They were awesome when they were written, but they code they are describing changed a whole lot! 
It helps to have people specifically tasked with keeping that sort of stuff up to date. :wistling:
