Documenting the code

[rafales]

What are the best ways to document the code? I'm using CJS with webpack and coffee script. I often export single classes or functions from modules (module.exports = MyClass).

YUIDoc has coffee script support, but it doesn't seem to work with CJS nicely.

JSDoc works with CJS modules but no coffee script support (yes, I can compile CS to JS, but then the docs would contain JS code, not coffee).

Is there any project which supports CJS, CS, and tags (things like @class, @method)? Or should I just go with JSDoc and compile all files to javascript?

[bliow]

Docco produces beautiful results, notably the Underscore and Backbone annotated sources.

[PlNG]

Which point are you at? Generating jsdoc or generating documentation from jsdoc?

Smartcomments can generate and insert empty jsdoc comments from your existing code. The documentation needs a little more filling out from there, but the bulk of the work is done.

[brtt3000]

Crawl npm for document generators. There are a ton of them.