[Specifications] Pull Request: Detailed specification for expects/returns and strongly typed collections

alien-mcl has just submitted a new pull request for https://github.com/HydraCG/Specifications:

== Detailed specification for expects/returns and strongly typed collections ==
Added specifies predicate to enable server for:
- detailed expects/returns resource description
- strongly typed collections description
Also added `mediaType` predicate for non-RDF resources.

This is an alternative approach for PRs #183 and #186 and should resolve #167 and #22.
In general - new `specifies` predicate is introduced through which a robust resource description in a reification-manner can be provided.

Only construct that worries me is in the strongly typed collection via API documentation, where a nested `manages` specification is provided. While specification can instruct on how the client should behave - the construct feels ... unnatural to me.

See https://github.com/HydraCG/Specifications/pull/187

Received on Wednesday, 27 February 2019 19:45:25 UTC