Improvements to API documentation.

* Added requirement to send header when POSTing config.xml to create a job.
* Don't tell anyone with Overall/Read the value of JENKINS_HOME.