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.

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 ...