Skip to content

TitanNano/es-code-docer

Repository files navigation

ES Code Docer

Greenkeeper badge Build Status David GitHub release npm npm

ES Code Docer is a modern code documentation tool for ECMAScript. The CLI application is designed for ECMAScript modules and supports the JSDoc comment syntax. Source Code files are parsed with the acorn ECMAScript parser and analysed for type information. The identified type information will be combined with the JSDoc type annotations and then rendered into the documentation.

Notice

ES Code Docer is not quite complete yet. If you have trouble running it on your project, feel free to file an issue for it.

Installation

npm -g i es-code-docer

Usage

es-code-docer ./src/

Multiple source files can be specified. For every file code docer will search for a package.json in order to deduce the project root. Currently there are three options for rendering the documentation which are hard coded at the moment. The options will be exposed soon and can be changed inside the index.js file for the time being.

Supported Render Outputs

ES Code Docer currently only implements a Markdown renderer, to implement additional renders should be straight forward though.

Supported JSDoc Tags

At the moment only the most important JSDoc tags are supported in the code docer.

  • @type
  • @return(s)
  • @private
  • @param
  • @deprecated

If not specified aliases are not supported. ES Code Docer tries to implement the JSDoc tags the way they are specified by JSDoc, but this is not always possible. JSDoc namepaths are not supported and most likely will never be. This is due to the fact, that ES Code Docer is based on the ECMAScript modules and does not implement the JSDoc module system.