* Docs: some language cleanup in readme and API reference

* Updates to docs language

* Fixing grammar in API reference doc