Minor editing and documentation cleanups for API model.
Merge pull request #118 from hintjens/master

Minor editing and documentation cleanups for API model.