doc-comments
Extract comments from JavaScript source code and generate API documentation.
Typically you want to add it to the dev dependencies `npm install --save-dev doc-comments.
Then call it from a script, e.g. put
"scripts":
into your package.json and run npm run doc
.
API
generateDoc(options, thenDo)
Reads JS source files, extracts toplevel, object, and function comments
and generates a documentation from these. Will insert doc into README.md or
doc files.
options {dryRun: BOOL, projectPath: STRING, files: ARRAY[STRING], intoFiles: BOOL}
intoFiles
: split documentation into individual doc/xxx.md files or README.md (default).
The README.md file should include insertion markers
<!---DOC_GENERATED_START--->
and
<!---DOC_GENERATED_END--->
.
var files = "lib/foo.js" "lib/bar.js"; projectPath: "/foo/bar" files: files { /*...*/ }/