Improve the put content request parameters description
Improve the put content request parameters description

 - Add more parameters from the semantics-of-the-publishing-api document.
 - Add a new section for the parameters that can be omitted for non-renderable
   document types.
 - Remove documentation that I think belongs elsewhere.

alphagov/publishing-api,alphagov/publishing-api