Do you guys know of any kind of documentation standards that are widely used within the Ethereum community? Any kind of documentation tools will also be of great help. Thanks in advance.
1 Answer
The Solidity Docs have a section describing the best way to document smart contracts. This special form is named the Ethereum Natural Language Specification Format (NatSpec).
Solidity contracts can use a special form of comments to provide rich documentation for functions, return variables and more. This special form is named the Ethereum Natural Language Specification Format (NatSpec).
-
2Your link is very helpful. In order to generate the output, it mentions
solc --userdoc --devdoc
, which generates JSON output. Would you happen to know any tool which generates some sort of standard PDF document? Something similar to Doxygen I suppose...? Commented Jun 13, 2019 at 13:44