> somewhat related to this direction there is a good project I'd like to see
> integrated on sparql endpoints and linked data api in general:
> https://helloreverb.com/developers/swagger
The difference between Swagger and Hydra
is that Swagger proposes a contract in advance.
That would be like reading a document
"to use Google, type /?q=search+term”
but that's not how the Web works.
Instead, Hydra provides hypermedia controls
that allow autonomous clients to find their way
without inspecting any documentation beforehand:
http://www.markus-lanthaler.com/hydra/console/?url=http://www.markus-lanthaler.com/hydra/api-demo/
Best,
Ruben