Improvements to API documentation.

* Added requirement to send header when POSTing config.xml.
* Don't tell anyone with Overall/Read where JENKINS_HOME is located
* Add an alternative to viewing config.xml files on the server for non-admins
Merge pull request #1122 from daniel-beck/api-doc

Improvements to API documentation.