Re: [Specifications] Discovering IriTemplate and others (#207)

Thanks for creating the issues!

Some thoughts about the conflict I always felt when I had to put the template either into the resource data or API documentation and why #207 together with #208 could fix it:

Besides the IriTemplates, everything in Hydra can be separated very well in resource data and API documentation. IriTemplates don't fit into only one of the two categories. The template contains the IRI of the resource, so it's somehow connected to the resource. But the benefit of the template data comes from using the API. Therefore the question is can it be shifted in one or the other direction? Using the template without using the API will not work. Shifting it towards the API documentation direction could work if it would be possible to remove the resource part of the IRI. Reducing the template to a relative part and resolve the full IRI with the resource IRI, could fix that problem. Then we would have a clear separation: The resource IRI comes from the resource data and the variable part comes from the API documentation.

-- 
GitHub Notification of comment by bergos
Please view or discuss this issue at https://github.com/HydraCG/Specifications/issues/207#issuecomment-600219033 using your GitHub account

Received on Tuesday, 17 March 2020 18:07:14 UTC