draft of first version of asciidoctor diagram docs

- TODO generated out file structure
- TODO sizing and positioning of image
- TODO link doc with other docs
Merge pull request #239 from graphitefriction/diagram

draft of first version of asciidoctor diagram docs