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
Merge pull request #11 from tacaswell/doc_work

Doc work