I would like to thank OZ team for a very quick ramp-up of this wonderful package, which has allowed us to auto-extract our contracts documentation into MD (MarkDown) files and make it properly visible on GitHub, GitBook and any other application or hosting-service which supports this format.
AFAIK, no other such package is currently viable specifically for Solidity (I have found a few projects, all of which seem to have been abandoned quite a while ago, and/or incomplete to a point which allows one to easily generate the docs).
This package is a pretty much “plug & play” utility, which makes it very easy to “get the job done” with almost zero effort. In addition to that, it also allows for advanced configuration of how your docs will appear, via an HBS (HandleBars) configuration file which is processed during execution.
For anyone interested, we have utilized this package in our repository:
This infrastructures allows us to generate our docs along with two other files:
Following that, we can publish the documentation on GitBook simply by registering our repository for this service (though the output docs must be added to the repo).
We (and anyone else seeking to do so) can auto-generate the docs via
npm run docify.
Thank you OZ!!!