Split docs into design and user facing.

Goal here is simply to make it easy for external
people to identify the relevant docs.
Merge pull request #98 from ambiata/topic/doc-cleanup

Split docs into design and user facing.