Updated the README to have some actual documentation in it. Updated other files to match our new apiary docs.
Merge pull request #5 from jeremyprice/update_documentation

Updated documentation