Use-Cases, Requirements, and Examples

Hi.
---
tldr; we have pages for -
use-cases & requirements: https://harshp.com/dpv-x/use-cases/
examples: https://harshp.com/dpv-x/examples/
data spreadsheet: 
https://docs.google.com/spreadsheets/d/1__STWvOEZRc1u2J-8teOYjLpnTPlZ80_ebTytrUlWgQ
relevant issue: https://github.com/w3c/dpv/issues/12

This is to enable recording the progression of DPV and assist in its 
eventual standardisation - where the use-cases and requirements play an 
important role in understanding why DPV was/is needed and if it is 'well 
designed'. Please help with populating this information.
---

# Use-Cases

We have a way to collect use-cases and requirements on to a page, and 
link them to concepts. For example, see Use-Case 
https://harshp.com/dpv-x/use-cases/#U2 refer to Requirement 
https://harshp.com/dpv-x/use-cases/#R2 which refers to dpv:Concept, 
dpv:Relation as concepts.

The HTML documentation shows this relation for use-cases and 
requirements through links, and has an appendix at end to do the inverse 
- provide a list where for each concept the relevant use-cases and 
requirements are listed.

The use-cases and requirements are taken from the spreadsheet, and also 
put into RDF at 
https://github.com/coolharsh55/dpv-x/blob/master/use-cases/ucr.ttl

The terms/relations used to describe use-cases and relevant concepts 
etc. are documented in the Vocabulary section of the page.

---

# Examples

Similar to use-cases, examples also have a vocabulary to describe 
content, a HTML page where they are listed along with relevant concepts, 
an appendix that provides for each concept the relevant use-cases, and 
are serialised as RDF at 
https://github.com/coolharsh55/dpv-x/blob/master/examples/examples.ttl

In addition, the Examples are files stored in /examples path (e.g. see 
https://github.com/coolharsh55/dpv-x/blob/master/examples/E0001.ttl), 
and have the option of being shown verbatim in the HTML documentation, 
as in https://harshp.com/dpv-x/examples/#E0001

The next step is to provide links to these examples in DPV vocabularies 
and documentations using vann:example.

---
Note the pages are not on the 'formal DPV' website yet. Once we discuss 
and finalise the documents/contents, I'll add them to w3c/dpv repo (the 
content is already on the local_hjp branch in this repo, but cannot be 
viewed live, which is why I use my website as a proxy to see 'drafts').
---

-- 
---
Harshvardhan J. Pandit, Ph.D
Research Fellow
ADAPT Centre, Trinity College Dublin
https://harshp.com/

Received on Wednesday, 12 October 2022 20:10:15 UTC