Have been writing more javascript lately, to the point where it would probably be nice if we started codifying our documentation a bit using similar methodologies we use in-house for other languages.

The problem with documenting code is that if you do it too early, it's just another thing to keep updated along with the code. And if you wait until the end, then you have no time or inclination to ...