generator) for Aventum!
Docsator accepts any JSDoc style comments and group the comments by tag and formats them to Markdown files.
Currently it is can collect only Aventum Hooks
Table of Contents
- Make sure you have the latest version of Node.js installed.
- Proper docsator.config.json file.
npm install @aventum/docsator -g
How to use it?
Go to the folder that contains the js(files/folders) and you have permissions to write into it and run:
Docsator will recursively collect the js files from the folders.
How it works
Docsator uses comment-parser behind the scenes to parse the comments.
Docsator reads its configurations from this file, here is a sample of what this file must contain:
You can create this file manually using any text editor, here is what every configuration means:
- replace and with: (String) Replace
withoption in the file name that will be printed in the documentation(the file that contains the comment, i.e. the source file), use either __dirname to refer the current folder or a hardcoded path.
- folder: (String) The folder that Docsator will put the documentation files in.
- tags: (Array) Array of tags, for the example above Docsator will generate hooks.md file that contains the formatted comments, these comments contain the
You are welcome to contribute code and provide pull requests for Docsator, also please feel free to suggest or request any features or enhancements.
Copyright (c) 2019 Mohammed Al-Mahdawi Licensed under the MIT license.