Setup a documentation build system

[adklempner]

I'm leaning towards using the Ethereum Natural Specification Format in the code and generating docs with Digix's Doxity (example here )

Another option is Read the Docs

[adklempner]

According to Aragon, Ethereum's natspec is unsafe and they recommend using their alternative, radspec

and the static site generator for their wiki is powered by MkDocs and Material for MkDocs

[adklempner]

Another options is solidity-docgen used by OpenZeppelin. It integrates with Facebook's Docusaurus, and on first glance I like it a lot. Quick to setup, feature-rich out of the box, and extensible.