[doc] the architecture cleanups.
Merge pull request #58 from Payum/doc-the-architecture-cleanups

[doc] the architecture cleanups.