Nascent Personality Manifestation

    es-code-docer

    1.0.0 • Public • Published

    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.

    Keywords

    Install

    npm i es-code-docer

    DownloadsWeekly Downloads

    0

    Version

    1.0.0

    License

    Apache-2.0

    Unpacked Size

    48.3 kB

    Total Files

    37

    Last publish

    Collaborators

    • titannano