- From: Martijn Faassen <faassen@startifact.com>
- Date: Thu, 4 Sep 2014 12:23:01 +0200
- To: Ruben Verborgh <ruben.verborgh@ugent.be>
- Cc: Markus Lanthaler <markus.lanthaler@gmx.net>, public-hydra@w3.org
Hi there, I agree it needs to be made accessible to non-RDF people, as I'm a non-RDF person. I think it can be with a bit more work. I'm not sure breaking up the spec into smaller pieces is really going to help though. I think much attention needs to be paid to how the spec is structured and how complete the examples are. You already introduce an issue tracker example, but you need to take that example seriously. Tell a story about how we have an issue tracker, and now we're going to use Hydra with it. How does a Hydra api document get found for it? How does it describe things about the web service (classes, describe terms as links, relationship to JSON-LD)? Now let's look at a create operation. What else can you do with a Hydra class. Etc. Step by step build up the story. I have some more detailed ideas for that which I hope to share later. Regards, Martijn
Received on Thursday, 4 September 2014 10:23:28 UTC