singleton document resource

[pvdbosch]

All examples in the guide of document resources are part of a collection, e.g. /persons/{ssin} We could also add examples of singleton resources, e.g. /persons/{ssin}/profilePicture

A document resource is either an instance part of a collection: /persons/{ssin} or a singleton document, of which only a single instance exists within the context of a parent document, if any:

    /endUserLicenceAgreement
   /persons/{ssin}/profilePicture

Name: singular noun

explain use case: when only single entity exists

• disclaimer: think about future evolution of the API, if more than one instance of the document resource could be needed in the future

edit: change singleton example, similar to existing examples

[pvdbosch]

I'll create a PR for review in next WG

[pvdbosch]

PR ready for review

[pvdbosch]

PR was merged, will be part of next release