Hydra

Hydra W3C Community Group Telecon

Minutes for 2019-04-08

Karol Szczepański: Meeting: Hydra W3C Community Group Conference Call

Topic: Last call actions

Karol Szczepański: First topic ist "Last call action points"
Could not provide cookbook examples for PR-186 yet
... focused on hydra console development
Live Demo of the console
Karol Szczepański: Angelo your API endpoint did not work, because no ApiDoc
Angelo Veltens: Angelo: I did not expose the Link header, but that is fixed meanwhile
Karol Szczepański: Want to get the features of the old Hydra console
Tomasz Pluskiewicz: I set up a hook to trigger hydra-notification channel
... it includes issues, PRs from github and twitter

Topic: Development of example API and client application

Karol Szczepański: There where some ideas on Slack
Karol Szczepański: - public transport ticket service
Karol Szczepański: - PSD2 compliant bank account service
Karol Szczepański: - bug trucker
Karol Szczepański: - cinema ticket ordering
Karol Szczepański: - restaurant / cofee shop ordering
Karol Szczepański: - eCommerce
Tomasz Pluskiewicz: What we do could be the basis for an acceptence test suite. Given this entrypoint, when you do x, then ....
... one repostitory for general JSON-LD API design and several other repos that implement it using different technologies
... Lorenzo already created a repo in HTTP-APIs org
... he replicated the realworld API with hydra
... might not be a bad idea to take the realworld API as is to be able to focus on hydra
... instead of discussion about domion
Angelo Veltens: Angelo: Can we implement every feature we want to support with hydra in such an API?
Tomasz Pluskiewicz: It's not hypermedia driven, but at least a big enough starting point
Angelo Veltens: Angelo: We could still have a second API if we see that this API will not cover everything
Tomasz Pluskiewicz: Let's first set up a repo with static files. JSON-LD written by hand
Karol Szczepański: this is similar to the tests in the reference client
Tomasz Pluskiewicz: Turn realworld stuff into JSON-LDs, serve them with express
Karol Szczepański: This way we have some comparision with other approaches
Tomasz Pluskiewicz: on the other hand there is client implementation
... once we have the server, even with static files, we could start implementing the UI
... Angelo you where also interested in building a client
Angelo Veltens: Angelo: You could have a domain-specific client that is generic regarding the JSON structure / needed API requests
Karol Szczepański: How do we want to proceed?
... we are working on different but similar things
Angelo Veltens: Angelo: What is the different between the Hydra Console and the generic client
Karol Szczepański: Hydra console is focussing on the ApiDoc, generic client more about browsing the data
... I like the cinema domain you are working on, Angelo, I would prefer it over realworld
Tomasz Pluskiewicz: You would have to take the "lead" about the cinema domain
Karol Szczepański: let's vote
Angelo Veltens: Angelo: What I like about the domain is that we could start with simple CRUD for movies, and advance to more complex hypermedia processes for ticketing
Karol Szczepański: realworld example:
Tomasz Pluskiewicz: +1/2
Karol Szczepański: cinematic example
Tomasz Pluskiewicz: +1
Karol Szczepański: +1
Karol Szczepański: cinemapi, is that correct?
Karol Szczepański: Shall we create a new repo for it
Angelo Veltens: Angelo: I wonder if we want to have several APIs: movies, events, tickets, and interlink them
Tomasz Pluskiewicz: We should use a monorepo
Tomasz Pluskiewicz: Just create the repo, we could rename it
ACTION: create repo named api-examples
Tomasz Pluskiewicz: we need more control over the CG from Markus
Angelo Veltens: Angelo: Could someone add me to the group
Tomasz Pluskiewicz: That's the point, we cannot
Karol Szczepański: I will ask markus
Tomasz Pluskiewicz: First Action item for you Angelo would be to start with an entrypoint and API doc
Karol Szczepański: Feel free to use nodejs
Tomasz Pluskiewicz: I create a bitwarden for passwords
... there is zapier and netlify in it
ACTION: aveltens to create a heroku account for free tier for Hydra CG
Tomasz Pluskiewicz: [ a SupportedProperty; collection [ a IriTemplate ] ]
Tomasz Pluskiewicz: [ a SupportedProperty; collection [ a Collection ] ]
ACTION: tpluskiewicz will create a cookbook for a way to provide a set of values for a property