Use cases and requirements

[ldibanyez]

Greetings CHIIR folk,

I am visiting your lovely conference from the Semantic Web planet, where we grow vocabularies, ontologies and exchange formats as integral part of our diet. After listening to the discussion around the manifesto paper (20h UTC one) mentioned all these (to me) magic words, I thought I would chime in.

Now, talking like a real GitHub issue: create a section with use cases and requirements: it is important that the community converges towards what they want to achieve with this vocabulary. It helps tremendously to have this before crafting JSON templates.

Here you have a couple of examples from groups that aim at getting standards certified by the W3C (Example 1, Example 2). As such, they follow protocol that for sure is an overkill here, but the following simplified workflow would be a good start:
(1) drivers of the initiative produce an initial draft (perhaps this has been produced already in the biiir workshop?). The way use cases are structured is something that I would take from the examples.
(2) initial draft is open to the community to comment and contribute (GitHub is nice for this part)

You may also draw inspiration from how those W3C working groups organise their github repos (e.g https://github.com/w3c/dxwg). Again, lots of W3C protocol, so just take what you need.

[scmmmh]

Thank you for all these pointers. Those are very helpful!