(#1238) - Minor fixes and additions to docs

Fixes some small spelling/grammar errors in the docs
and adds some more information, especially to the
API page.