I was able to get solidity docgen working by implementing a series of three different stages all automated in our build process.

1. Parse the solc output into actual json.
2. Load the json file into the documentation system
3. Use a Jinja template to convert the api document

There is shockingly poor …