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

alien-mcl has just closed alien-mcl's pull request 187 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


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Tuesday, 2 February 2021 19:05:33 UTC