documentation

The documentation system for modern JavaScript

• Supports modern JavaScript: ES5, ES2017, JSX, and Flow type annotations.
• Infers parameters, types, membership, and more. Write less documentation: let the computer write it for you.
• Integrates with GitHub to link directly from documentation to the code it refers to.
• Customizable output: HTML, JSON, Markdown, and more

Examples

• HTML output with default template
• Markdown
• JSON

Documentation

• Getting Started: start here
• Usage: how to use documentation.js
• Recipes: tricks for writing effective JSDoc docs
• Node API: documentation.js's self-generated documentation
• Configuring documentation.js
• FAQ
• Troubleshooting
• Theming: tips for theming documentation output in HTML
• See also: a list of projects similar to documentation.js

User Guide

Globally install documentation using the npm package manager:

$ npm install -g documentation

This installs a command called documentation in your path, that you can point at JSDoc-annotated source code to generate human-readable documentation. First run documentation with the -h option for help:

Usage:

# generate markdown docs for index.js and files it references
bin/documentation.js build index.js -f md

# generate html docs for all files in src
bin/documentation.js build src/** -f html -o docs

# document index.js, ignoring any files it requires or imports
bin/documentation.js build index.js -f md --shallow

# build and serve html docs for app.js
bin/documentation.js serve app.js

# build, serve, and live-update html docs for app.js
bin/documentation.js serve --watch app.js

# validate JSDoc syntax in util.js
bin/documentation.js lint util.js

# update the API section of README.md with docs from index.js
bin/documentation.js readme index.js --section=API

# build docs for all values exported by index.js
bin/documentation.js build --document-exported index.js

Commands:
  serve [input..]   generate, update, and display HTML documentation
  build [input..]   build documentation
  lint [input..]    check for common style and uniformity mistakes
  readme [input..]  inject documentation into your README.md

Options:
  --version  Show version number                                       [boolean]
  --help     Show help                                                 [boolean]

Contributing

We have plenty of issues that we'd love help with.

• Robust and complete JSDoc support, including typedefs.
• Strong support for HTML and Markdown output
• Documentation coverage, statistics, and validation

documentation is an OPEN Open Source Project. This means that:

Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.

Changelog

4.0.0 (2017-07-27)

Bug Fixes

• html output: Fix links between navigation and items in HTML documentation (5fb77bc)
• package: update babel-generator to version 6.25.0 (#804) (65f5a37)
• package: update chalk to version 2.0.0 (#833) (2329db4)
• package: update github-slugger to version 1.1.3 (#793) (74392cc)
• Show () for callbacks (61968c7)
• package: update micromatch to version 3.0.0 (#792) (3f2bf90)
• package: update remark to version 8.0.0 (1ae8136)
• Fix filtering in the default theme (473f317)
• Report nesting errors instead of throwing them as errors (ea69608), closes #832
• package: update remark-html to version 6.0.1 (#815) (e472550)
• package: update vfile-reporter to version 4.0.0 (a3e1fb8)

<a name="4.0.0-rc.1"></a>