Re: [Specifications] [client-interface] Suggestion for browser-like client API

> @lanthaler the original version guided me to believe that the document should not just outline an interface but show a pseudocode application which makes use of the hydra client library:

Yes, I indeed wanted to show how the client looks like in use. It doesn't need to be a full application. Some simple use cases (retrieve a resource, retrieve all items from a collection, execute an operation, etc.) should be enough. It helps to understand the usability of the interface.

> If somebody else would rather write a totally different initial PR and actually tasks himself to do it very soon, let's wait.

No, we definitely shouldn't do that IMO :-)


> Obviously it is not a good mode of operation if everybody tells me they had a very different idea, asking me to bring their idea to life - accompanied by jeers and catcalls ;-) Or at least that is how it felt on my end.

Well, we will need to have some discussions at some point. Since the group decided to move most of the work to GitHub, a PR feels like a good opportunity to have such a discussion. Don't see it as criticism but as constructive feedback. It's your PR, so feel free to push back, address it by leaving a note or todo in the doc or something else. I'm actually really happy to see such lively discussions again but I can imagine how it may have felt on your end.

So, to move forward I'd suggest to go through the comments and address them in whatever way you feel is appropriate. Adding a section "open questions" or something along those lines would work quite well for lots of them given that this is a working doc. We can then merge this and someone else can pick up one of the questions or make changes to the doc that we will then discuss separately.

Does that sounds like a reasonable way forward?

-- 
GitHub Notification of comment by lanthaler
Please view or discuss this issue at https://github.com/HydraCG/Specifications/pull/111#issuecomment-289869745 using your GitHub account

Received on Tuesday, 28 March 2017 18:56:04 UTC