Create beautiful automatically generated documentation for Ethereum smart contracts.
This repository contains the source code for the CLI portion of EthDoc. An Open Source developer tool that generates documentation for Smart Contracts using Ethereum Natural Specification Format.
The easiest way to get started with EthDoc is through the CLI. Follow the instructions below to get started!
$ npm install ethdoc --save
$ ethdoc init
This may take a few minutes. You only have to run this command the first time you integrate EthDoc into an Ethereum Project.
$ ethdoc generate contracts/ -s
Pass the name of the folder where your contracts are. In the example above, we chose contracts/
. But if your contracts reside in some otherDirectory/
you can just pass it in as an argument. Here's an example below:
$ ethdoc generate otherDirectory/ -s
🎉 Navigate to http://localhost:3000 to check out your docs 🎉
The EthDoc CLI was built using Oclif which is a framework for building CLIs in Node made by the awesome people over at Heroku!
$ npm install
$ npm link
This command makes it so that the ethdoc
command runs the program located in current directory vs. your globally installed version.
If you're done developing and would like to use the globally installed version, just run npm unlink
.