...
need to add a copy of the lifecycle states from XML terminology to the REST overview documentation commit audit header.
Where are Uids supplied from
Question of whether Composition uids should be supplied from the client side;
Reason to supply Uid is when it is to be used in FOLDERs referencing the COMPOSITION - this enables a single Contribution to contain FOLDER updates in the same CONTRIBUTION as COMPOSITION.
POST doesn't allow Uid; can use PUT without match-if header, and a supplied Uid.
Split PUT Composition into 2 calls - one with Version Uid supplied; other without; simplify documentation.
If Version Uid is supplied: it should all be there, including version = 1
Last updated
Heath: add a last-updated: date_time header (formatted according to HTTP rules, i.e. no milliseconds). For all GETs; ?POST response as well.