DOC : addid helper file for rtd
DOC/WIP : work to re-format arch decisions into rst
DOC : More tweaks to architecture docs

 - some style changes
 - minor content changes to VC section
 - added missing sections