This is a long winded first post that will eventually explain why this blog exists in the first place so.. bear with me. I've broken this post into 2 parts: first some thoughts on comments in code and then on documentation in general.
Documentation in Code
The practice