Array manipulation methods (e.g. Push) in the commits

[joepio]

Commits have a set property, which can be used for adding items to arrays.

However, this leads to sometimes unnecessarily large commits when an item is added to an array. For example, the use case of adding a paragraph to a document.

We could introduce one of mors methods to for doing this. However, keep in mind that extending commits has serious implications for all involved. They can be very complex to manage in stateful systems, such as forms in a front end library.

Insert property

The insert property takes an array of anonymous resources, each of which is an insert, which contains:

• property url
• location
• value to insert

append / push

• An object named push, for which every key is a Propery that is to be appended / pushed to
• Eeach value is a ResourceArray, i.e. an array of Subjects or Nested Resources