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.
1 Like
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: