vigour-doc

A collection of tools to help make great docs with minimal effort

$ npm install vigour-doc

usage

Opt-in to certain behaviors by including placeholder comments in your .md files. Then, run vdoc (see vigour-config docs)

$ vdoc

clean

Cleans the generated content on files. Important it's necessary to pass true because of a small bug on vigour-config

$ vdoc --clean true

• name : name of plugin
• options : (optional) JSON options for plugin

example

README.md

<!-- VDOC.badges travis; standard; npm -->

See vigour-doc-badges for available badges

jsdoc

Fetches the jsdoc-style comment block containing @id <ID>, converts it to github-flavoured markdown, and replaces the placeholder with the result

<!-- VDOC.jsdoc <ID>  -->

• ID : Identifier to find the desired comment block

example

lib/start.js

/**
 * @id start
 * @function start
 * Searches the directory recursively and updates any vdoc sections
 */
module.exports = exports = function start () {

README.md

<!-- VDOC.jsdoc start -->