Outline of architecture
Clarifications on architecture.
Closing pull request #2