Update REST api docs

* Minor grammatical or wording changes
* Remove credentials from certain responses
* Correct a reference to the "Jar" job type (should be MapReduce)

Partial-Implements: blueprint update-docs-icehouse
Change-Id: I6b0d2a3f1d76e9005b1c21af501c75441e56710f
Merge "Update REST api docs"