improve architecture doc
Merge pull request #97 from btford/docs-arch

Improve architecture doc