This patch is addressing the comments left in the original Redfish
documentation patch.
It mostly re-words some of the redfish properties and also makes it more
explicit what is required and what is optional.
Change-Id: Id02e85e80cb3a5518493a3e7af71cef64725a856