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 ...
Not long ago, “good engineering hygiene” meant leaving a trail of breadcrumbs in the code: comments explaining what a function does, wiki pages describing how services interact and auto-generated API ...