Remove duplication with readme. Remove unneeded spaces. Prevent people writing ~git in the documentation. Descriptive headers.
 Merge branch 'architecture' into 'master'

Architecture

Cleanup of architecture doc.