Refined design to account for initial comments and improve usability of the API from client code:
- Use collections instead of arrays to be able to access sub-elements by name directly
- Encode field names to be coherent with URIs, added "name" field to record unencoded name to avoid having to propagate encoding logic to all clients
- Removed big example, splitting it into small examples instead. WIP.
- Made type links coherent by using the "type" field name for all
- Added "isMultiple" field on properties representation to ease processing of values
- Enclosed properties into a "props" sub-element
- Added section on simplified PUT/POST usage and simplified value write for properties