Home Manual Reference Source Test

OOP API document

Installation

npm install -D \
    eslint \
    babel-eslint \
    esdoc \
    esdoc-standard-plugin \
    esdoc-ecmascript-proposal-plugin \
    esdoc-external-nodejs-plugin

Configuration

.esdoc.json

{
    "source": "./source",
    "destination": "./docs",
    "plugins": [
        {
            "name": "esdoc-standard-plugin",
            "option": {
                "accessor": {
                    "access": ["public", "protected"],
                    "autoPrivate": false
                }
            }
        },
        {
            "name": "esdoc-ecmascript-proposal-plugin",
            "option": {
                "all": true
            }
        },
        {
            "name": "esdoc-external-nodejs-plugin",
            "option": {
                "enable": true
            }
        }
    ]
}

.eslintrc.json

{
    "env": {
        "es6": true,
        "node": true
    },
    "parser": "babel-eslint",
    "parserOptions": {
        "ecmaVersion": 9,
        "sourceType": "module",
        "ecmaFeatures": {
            "legacyDecorators": true
        }
    },
    "extends": "eslint:recommended",
    "rules": {
        "valid-jsdoc": [
            "error",
            {
                "prefer": {
                    "returns": "return"
                },
                "requireParamDescription": false,
                "requireReturn": false,
                "requireReturnDescription": false
            }
        ]
    }
}

package.json

{
    "scripts": {
        "lint": "eslint source/ --fix",
        "docs": "npm run lint  &&  esdoc"
    }
}

Generating

npm run docs