Update notes for submitted changes

* re-org docs & add details on production architecture