CLI tool that extracts information from React Components using react-docgen, transforms that information into Markdown and adds it to your README file.
$ npm install --save-dev react-docgen-docs
$ rdd <componentsDir> [options]
// `rdd` is a shortcut for `react-docgen-docs`
-
Add the delimiter in your README file to indicate where you want to insert the docs
<!-- react-component-api -->
-
Then add a new task in your package.json to generate the docs. Note that you must specify the path for the readme and for the components to be documented.
"scripts": { "docs": "rdd src/ --readmeFile docs/README.md" }
Default: './README.md'
The path to the readme file where generated documentation is appended.
Default: 'react-component-api'
Use a custom delimiter. Used to let the tool know where to place the docs in your readme.
This generates <!-- react-component-api -->
and <!-- react-component-api:end -->
delimiters.
Default: ['.js', '.jsx']
File extensions to consider. Used by react-docgen
.
Default: ['node_modules', 'bower_components']
Folders to ignore. Used by react-docgen
.