A plugin for dmd and jsdoc-to-markdown to provide more readable docs

npm install dmd-readable

Pass the plug-in name to jsdoc2md or dmd:

jsdoc2md --plugin dmd-readable

This plugin (which was used to generate this readme) does a few things:

• removes global indexes (see below)
• places descriptions in block-quotes (Use @summary for descriptions without block quotes)
• adds more whitespace before headings
• changes the delimiter for multiple types in param tables to a comma
• adds alias output

The removal of global indexes is now a setting in the template. If you are using your own template and you wish to retain this feature, add the following line to your template:

{{optionSet "global-index-format" "none"~}}

All options for global-index-format are "none", "grouped", "table", "dl". Other options and more info can be found here.

This plugin also provides the following helper functions:

Reads info from the package.json file.

See: docs.hbs for an example of how to use this function

Implements the library change-case.

See: docs.hbs for an example of how to use this function

Prefixes a string to the beginning of each line in the first string

Finds an object in an array with a matching key: value

Calls string.replace

Determines if the provided string is truthy and is different than the string provided the previous time this function was called