first stab at schema docs
reformatting
Merge pull request #1120 from h4ck3rm1k3/master

first stab at schema docs