arch docs
Merge pull request #1577 from tiagojsag/arch_docs

Clean up architecture chapter