Add basic API usage documentation

Also rearrange a few things
Merge pull request #101 from LinuxJedi/error_docs

Add basic API usage documentation
Fix typo in docs