dpv v0.4: dpv-gdpr,dpv-pd;dpv-owl,dpv-skos;Primer

DPV v0.4 makes important and backwards incompatible changes in terms of
how it expresses the concepts and relationships. It also moves the
namespace to w3id.org for all its documents. Most importantly, DPV is now
presented as an abstract 'data model' that is recorded using SKOS.
Specific serialisations are provided for use as an ontology in two
variants: first using SKOS+RDFS and the second using OWL2. In addition
to these, the personal data concepts have been moved to a separate
extension, i.e. DPV-PD, to prevent overlap and conflict with other
concepts still in DPV. A Primer has been added to provide an overview of
the DPV, its semantics, and concepts, and also to explain the above
changes in structure.

For more information, see Changelog.html

README.md

@@ -5,11 +5,14 @@ Data Privacy Vocabularies and Controls Community Group (DPVCG) repository
 
 The mission of the W3C Data Privacy Vocabularies and Controls CG (DPVCG) is to develop a taxonomy of privacy and data protection related terms, which include in particular terms from the new European General Data Protection Regulation (GDPR), such as a taxonomy of personal data as well as a classification of purposes (i.e., purposes for data collection), and events of disclosures, consent, and processing such personal data.
 
+> Newcomers to the DPV are recommended to start with the [Primer](https://w3id.org/dpv/primer) to familiarise themselves with the concepts, semantics, and usefulness of the DPV.
+
 License: All work produced by DPVCG and provided through this repo or elsewhere is provided by contributors under the [W3C Document License](https://www.w3.org/Consortium/Legal/2015/doc-license). A copy of the license is provided in the [LICENSE.md](./LICENSE.md) file.
 
 Outputs:
-  * Data Privacy Vocabulary (DPV) - [https://w3.org/ns/dpv](https://w3.org/ns/dpv)
-  * GDPR terms for Data Privacy Vocabulary (DPV-GDPR) [https://w3.org/ns/dpv-gdpr](https://w3.org/ns/dpv-gdpr)
+  * Primer: Introduction to the Data Privacy Vocabulary - [https://w3id.org/dpv/primer](https://w3id.org/dpv/primer)
+  * Data Privacy Vocabulary (DPV) - [https://w3id.org/dpv](https://w3id.org/dpv)
+  * GDPR terms for Data Privacy Vocabulary (DPV-GDPR) [https://w3id.org/dpv/dpv-gdpr](https://w3id.org/dpv/dpv-gdpr)
 
 Publication: 
  * Pandit H.J. et al. (2019) Creating a Vocabulary for Data Privacy. In:  Panetto H., Debruyne C., Hepp M., Lewis D., Ardagna C., Meersman R.  (eds) On the Move to Meaningful Internet Systems: OTM 2019 Conferences.  OTM 2019. Lecture Notes in Computer Science, vol 11877. Springer, Cham.  https://doi.org/10.1007/978-3-030-33246-4_44
@@ -29,15 +32,23 @@ The vocabulary provides terms to describe:
 * rights as applicable
 * risks as applicable
 
-The namespace for DPV terms is `http://www.w3.org/ns/dpv#` with suggested prefix `dpv`. The IRI for DPV is currently redirected to serve the files hosted in this repository from GitHub pages i.e. `https://w3c.github.io/dpv/dpv/` (thanks to @bert-github for setting this up). Content-negotiation should therefore be supported for all files/serialisations of the DPV and its modules.
+The namespace for DPV terms is `http://www.w3id.org/dpv#` with suggested prefix `dpv`. The IRI for DPV is currently redirected to serve the files hosted in this repository from GitHub pages i.e. `https://w3c.github.io/dpv/dpv/` (thanks to @bert-github for setting this up). Content-negotiation should therefore be supported for all files/serialisations of the DPV and its modules.
+
+## DPV Family of Documents
+
+* [DPV-Primer](https://www.w3id.org/dpv/dpv-primer): The Primer serves as an introductory document to DPV and provides an overview of its concepts.
+* [DPV](https://www.w3id.org/dpv/): The DPV Specification is the formal and normative description of DPV and its concepts. It provides a serialisation of the concepts as a taxonomy using SKOS.
 
-### DPV-GDPR
+**Extensions to Concepts**
 
-The [**DPV-GDPR**](https://w3.org/ns/dpv-gdpr) vocabulary expands on the DPV vocabulary to provide the specific legal basis, rights, and concepts defined within GDPR. It expands or specialises the concepts in DPV for use with GDPR.
+* [DPV-GDPR](https://www.w3id.org/dpv/dpv-gdpr): Extension expands on the DPV vocabulary to provide the specific legal basis, rights, and concepts defined within GDPR. It expands or specialises the concepts in DPV for use with GDPR.
+* [DPV-PD](https://www.w3id.org/dpv/dpv-pd): Extension to the DPV providing a taxonomy of personal data categories.
+* [DPV-NACE](https://www.w3id.org/dpv-nace): [NACE](https://ec.europa.eu/eurostat/ramon/nomenclatures/index.cfm?TargetUrl=LST_NOM_DTL&StrNom=NACE_REV2) industry standard classification system used in the EU serialised in RDFS
 
-### DPV-NACE
+**Serialisations of DPV**
 
-The [**DPV-NACE**](https://github.com/w3c/dpv/tree/master/dpv-nace) vocabulary provides a RDFS and DPV compatible serialisation of the  [NACE](https://ec.europa.eu/eurostat/ramon/nomenclatures/index.cfm?TargetUrl=LST_NOM_DTL&StrNom=NACE_REV2) industry standard classification system used in the EU.
+* [DPV-SKOS](https://www.w3id.org/dpv/dpv-skos): A serialisation of the DPV using RDFS and SKOS to enable its use as a lightweight ontology for modelling or annotating information. This serialisation can be used in cases where the DPV is to be used as a 'data model' or 'schema' without formal logical assertions. It is suitable in cases where simple(r) inferences are required, or where the strict interpretation or restrictions of OWL are not needed, or the rules/constraints are expressed in another language (e.g. SWRL or SHACL).
+* [DPV-OWL](https://www.w3id.org/dpv/dpv-owl): a serialisation of the DPV specification using OWL language. It should be used where the additional semantic relationships offered by OWL (based on description logic) are needed for modelling knowledge and describing desired inferences. OWL offers more powerful (and complex) features compared to RDFS regarding expression of information and its use to produce desired inferences in a coherent manner. 
 
 ### DPV and Modules
 

documentation-generator/001_download_vocab_in_csv.py

@@ -14,19 +14,35 @@
 # The sheet names are assumed to be valid IRIs
 # If they are not, escape them for IRI/HTML representation
 DPV_SHEETS = (
+    # Namespaces
+    'Namespaces',
+    'Namespaces_Other',
     # DPV
     'BaseOntology',
     'BaseOntology_properties',
-    'PersonalDataCategory',
+    'PersonalData',
+    'PersonalData_properties',
+    'dpv-pd',
     'Purpose',
     'Purpose_properties',
+    'Context',
+    'Context_properties',
     'Processing',
     'Processing_properties',
+    'ProcessingContext',
+    'ProcessingContext_properties',
     'TechnicalOrganisationalMeasure',
     'TechnicalOrganisationalMeasure_properties',
     'Entities',
     'Entities_properties',
+    'Entities_LegalRole',
+    'Entities_LegalRole_properties',
+    'Entities_Organisation',
+    'Entities_DataSubjects',
+    'Jurisdictions',
+    'Jurisdictions_properties',
     'LegalBasis',
+    'LegalBasis_properties',
     'Consent_properties',
     # DPV-GDPR
     'GDPR_LegalBasis',