This project provides JSDoc and a collection of plugin's that I use for most of my JavaScript projects.
It abbreviates the necessary dependencies for our projects, allowing me to include fewer libraries for our JSDoc generation needs.
I wanted a simple way to add JSDoc documentation to all (or most) of my Javascript projects without needing to train each of my coworkers on the intricacies of JSDoc execution and configuration. My hope was that this, in turn, would lead to a wider adoption rate of JSDoc in my projects.
I also wanted to make my JSDoc output more consistent.
Use NPM to install this library as a devDependency
of your project:
$ npm install --save-dev --save-exact lukes-jsdoc
conf/docs/html.json
{
"source" : {
"include" : [
"lib",
"package.json",
"README.md"
],
"includePattern" : ".js$",
"excludePattern" : "(node_modules/|docs)"
},
"opts" : {
"destination" : "./doc/html/",
"template" : "./node_modules/lukes-jsdoc"
}
}
$ cd /path/to/myproject
$ node node_modules/lukes-jsdoc/node_modules/jsdoc/jsdoc.js --configure conf/docs/html.json
The above example is a minimal implementation. You should, at least, add your documentation generation to an "npm script". More information about that is outlined in the Usage Document.