Need a documentation solution

[mormj]

Since so much of the code is generated, including the public header files, doxygen doesn't make as much sense anymore

Seems it would be feasible to:

1. have a docs/ directory in-tree
2. put all the usage guides there (what is currently in gh-pages)
3. automatically generated block docs from the yml

The yml could have a block level description, and then a doc attribute for each parameter

sphinx/readthedocs