4

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 1

3

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).

1
  • 2
    Your 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

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.