Add package docs and describe high-level patterns.
Merge pull request #183 from pmorie/docs

Merged by openshift-bot