search

HydraCG / Specifications

Specifications created by the Hydra W3C Community Group
Other
139 stars 25 forks source link

State more explicitely that hydra:return etc. are just hints #21

Closed lanthaler closed 3 years ago

lanthaler commented 10 years ago

See http://lists.w3.org/Archives/Public/public-hydra/2013Dec/0014.html and http://lists.w3.org/Archives/Public/public-hydra/2013Dec/0015.html for more information.

bradjonesca commented 10 years ago

Second link is returns a 404

lanthaler commented 10 years ago

Nice race condition :-) I was creating the link before clicking “send” on the mail I was writing.. It’s working now.

alien-mcl commented 3 years ago

I think this is covered in the spec now (section 4.2 Documenting a Web API):

Keep in mind that operations specified in an ApiDocumentation may fail at runtime as either resources or the ApiDocumentation itself have changed since they have been retrieved. Also operation details like returns or possibleStatus may vary at runtime, which means client SHOULD verify received payloads at runtime.

How do you feel about it?

alien-mcl commented 3 years ago

OK - I'm closing it. It may happen that the snipped provided in my previous post may change it's location in the spec, still I feel topic of this issue is covered. Closing