Revision to the versioning section in DCAT3 FPWD #1295

andrea-perego · 2021-02-13T10:26:43Z

This PR includes a new draft for discussion on versioning support in DCAT, as per ACTION-438.

Preview: https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html#dataset-versions

Diff: https://services.w3.org/htmldiff?doc1=https%3A%2F%2Fw3c.github.io%2Fdxwg%2Fdcat%2F&doc2=https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html#dataset-versions

Summary of changes:

Compared with the first draft in the DCAT3 FPWD, the versioning section has been revised to focus specifically on versions derived from the revision of a resource, and by following the approach of the PAV ontology for the specification of version chains and hierarchies (the version history).

In particular, the introductory text has been revised according to the new scope, the section on version types has been removed, and a new section has been added to describe how to specify relationships between versions, whereas backward compatibility aspects, originally included in §10.2 Version information have been removed (see #1258). Moreover, a new section has been added at the end to compare the DCAT versioning approach with those used in OWL and DCTERMS.

The other sections include only editorial changes.

EDNOTEs have been added to highlighted the relevant revisions.

NB: All the properties described in this section are yet to be added to §6. Vocabulary specification and to the RDF definition of DCAT.

riccardoAlbertoni · 2021-02-14T13:01:48Z

Draft accessible at https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html#dataset-versions

Diff available at https://services.w3.org/htmldiff?doc1=https%3A%2F%2Fw3c.github.io%2Fdxwg%2Fdcat%2F&doc2=https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html

dr-shorthair · 2021-02-16T09:28:04Z

Nice work guys. Reads well. (also the dataset series section)

dr-shorthair · 2021-02-16T09:29:34Z

dcat/index.html

+
+<aside class="ednote">
+<p>This is a new draft for discussion on versioning support in DCAT.</p>
+<p>Compared with the first draft in [[VOCAB-DCAT-3-20201217]], this section has been revised to focus specifically on versions derived from the revision of a resource, and by following the [[PAV]] approach for the specification of version chains and hierarchies - previous, next, current, last version.</p>


Limiting the scope in this way is pragmatic and sensible.

dr-shorthair · 2021-02-16T09:32:36Z

dcat/index.html

+<li><code>dcat:previousVersion</code> (equivalent to <a data-cite="?PAV#d4e459"><code>pav:previousVersion</code></a>)</li>
+<li><p><code>dcat:hasVersion</code> (equivalent to <a data-cite="?PAV#d4e395"><code>pav:hasVersion</code></a>), plus the following additional properties:</p>
+<ul>
+<li><code>dcat:isVersionOf</code> (inverse of <code>dcat:hasVersion</code>);</li>


In general inverse-properties are to be avoided (you can always add the reverse triple to a graph) but occasionally there is a pretty compelling case from usage. This is probably such.

I agree. In the text I tried to make it clear that the only key properties are dcat:hasVersion and dcat:previousVersion, whereas the other ones should be used if needed by the relevant use case.

dr-shorthair · 2021-02-16T09:34:33Z

dcat/index.html

+<li><a data-cite="VOCAB-ADMS#adms-last"><code>adms:last</code></a> is defined as <q>A link to the current or latest version of the Asset</q>, whereas in [[PAV]] the current and latest versions of a resource may be different, and link to by using different properties.</li>
+</ul>
+<p>Moreover, although the definitions of the [[VOCAB-ADMS]] properties states explicitly that they are meant to be used for "versions", they are subproperties of the corresponding terms in [[XHTML-VOCAB]], where they are used to link resources in a collection (e.g., the set of pages of a Web site). E.g., the definition of <a data-cite="XHTML-VOCAB#last"><code>xhv:last</code></a> reads as follows: <q>last refers to the last resource in a collection of resources.</q>.</p>
+<p>Based on that, in this draft, [[PAV]]-equivalent properties are used for versions, whereas the [[VOCAB-ADMS]] ones are used for dataset series (<a href="#dataset-series"></a>). Properties <code>dct:hasVersion</code> / <code>dct:isVersionOf</code> are not used.</p>


Will you include owl:equivalentProperty axioms in the RDF?

BTW - I agree with not using PAV directly. It was nicely designed but has rarely been used, and thus would be an unnecessary and out-of-date dependency. I was on a call with Stian Soiland-Reyes and he expressed some surprise that there was continued interest in PAV. So I think we can assume that PAV itself is no longer a going concern.

That's very useful, @dr-shorthair .

About your first question, equivalence in the RDF can be stated either formally or informally. What would you suggest?

dr-shorthair · 2021-02-16T09:36:27Z

dcat/index.html

 <div class="issue" data-number="1271"></div>
+
+<aside class="ednote">
+<p>This draft proposes the definition of a new property <code>dcat:version</code>, to use instead of <code>owl:versionInfo</code> of the first draft.</p>


andrea-perego · 2021-02-16T21:25:29Z

Nice work guys. Reads well. (also the dataset series section)

Thanks, Simon. I've just added a new section, to explain how DCAT can be used to describe versioning complementarily with other vocabularies. Could you please have a look at it?

https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html#versioning-complementary-approaches

griddigit · 2021-02-16T21:56:00Z

Dear all, It is very good that such details are added. I am wondering if it is possible to also add some detail on the linkage between DCAT and PROV-O. It is true that there are some hints in the document on multiple places, but it would be nice to state in on place the overall picture. For instance Resource, Dataset, Distribution, .... are members of prov:Entity and explain in which cases etc. if there is some difference Prov also has wasRevisionOf and some related so these can be mentioned in the tale under the versioning Best regards Chavdar

riccardoAlbertoni · 2021-02-17T11:21:01Z

Thank Andrea, for preparing this PR. I agree on the line of extending the DCAT support taking into account PAV's equivalent terms and I like the way the versioning is presented.

I report some observations that have crossed my mind reading the draft. I hope they might help the discussion in the next DCAT call.

I think that the ability to determine the latest/current version is a very fundamental use case when people look for data (what is the latest (official or draft) version released?). Considered this, I wonder if we need to bind more explicitly the semantics of dcat:currentVersion and dcat:lastVersion to the dct:replaces and dcat:previousVersion chains. For example, saying " dcat:lastVersion is the head of the dcat:previousVersion property chain and dcat:currentVersion is the 'head' of the dct:replaces chain". That might provide an agreed way to work out the latest version and current version, which might help maintain the metadata consistent and updated.
Is owl:versionInfo a sub-property of dcat:version? Is owl:priorVersion sub-property of owl:priorVersion? Or do we want to keep DCAT versioning and OWL versioning as two distinct alternative approaches?
Should we align the DCAT versioning with DCAT provenance? PAV aligns with DCT, and PROV (see SPRINT on Versioning for a summary). If we state the owl:equivalentProperty to PAV's terms, that will induce these alignments for the DCAT's, but that is quite an indirect way to have DCAT versioning align with DCT and PROV for versioning. In case we want to keep the alignments provided by PAV for DCT and PROV, I suggest restating them explicitly in DCAT. This could be also the occasion to double-check that these alignments hold and fit well in DCAT. Whether these alignments will be normative or not is another issue that we might need to debate.

…stop dataset

andrea-perego · 2021-03-05T16:47:41Z

I am wondering if it is possible to also add some detail on the linkage between DCAT and PROV-O.
It is true that there are some hints in the document on multiple places, but it would be nice to state in on place the overall picture. For instance Resource, Dataset, Distribution, .... are members of prov:Entity and explain in which cases etc. if there is some difference
Prov also has wasRevisionOf and some related so these can be mentioned in the tale under the versioning

Thanks for your feedback, @griddigit . We are still finalising the versioning part, and including an alignment with PROV is one of the aspects that we will consider.

@griddigit , a comparison with PROV has been added via commit 3b9371f - see https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html#versioning-complementary-approaches

andrea-perego · 2021-03-10T15:47:06Z

All the discussed revisions have been implemented.

Unless there are any objections, I would merge this PR, and create a new one for future changes.

agbeltran · 2021-03-10T15:54:29Z

thanks @andrea-perego - I agree it should be merged as comments have been addressed.

riccardoAlbertoni · 2021-03-10T16:03:19Z

Yes, please merge this.

Initial revision the versioning section

0577f10

andrea-perego added 2 commits February 14, 2021 15:28

Editorial changes

25e43ec

Editorial changes

70a727a

andrea-perego added dcat versioning labels Feb 14, 2021

andrea-perego added this to In Progress in DCAT Sprint: Versioning via automation Feb 14, 2021

andrea-perego added this to the DCAT3 2PWD milestone Feb 14, 2021

Editorial changes

1cb61d1

andrea-perego marked this pull request as ready for review February 14, 2021 19:31

andrea-perego requested review from agbeltran, davebrowning, dr-shorthair, pwin and riccardoAlbertoni February 14, 2021 19:32

andrea-perego added 4 commits February 14, 2021 20:50

Editorial changes

e6168e3

Editorial changes

69cc536

Editorial changes

36d9b59

Add entry in changelog

aab68c2

dr-shorthair reviewed Feb 16, 2021

View reviewed changes

dr-shorthair approved these changes Feb 16, 2021

View reviewed changes

andrea-perego added 2 commits February 16, 2021 20:59

Editorial fixes

bc0f0d5

Add new section to compare versioning in DCAT, OWL, and DCTERMS

a12f83e

andrea-perego and others added 3 commits February 27, 2021 18:42

Editorial revision to changelog

4816f3c

Editorial change

d7d0472

Merge branch 'gh-pages' into dcat-versioning-v2

43a03b6

andrea-perego mentioned this pull request Mar 2, 2021

Describing the "Release Type" #1289

Closed

andrea-perego added 9 commits March 2, 2021 23:09

Editorial changes

ce620e2

Revised versioning diagrams and create alt versions

b6b45d8

Fix obsolete EPSG CRS URL

26a4c8f

Replace DCAT versioning diagrams with a new one about the MyCity bus …

5fe2778

…stop dataset

Revise example on the use of OWL and DCAT for versioning DCAT2

caa18c2

Remove dcat:hasLastVersion

1b2456a

Add comparison with PROV in the versioning section

3b9371f

Editorial fixes

6527c34

Editorial fixes

f64750d

andrea-perego changed the title ~~Revision to the versioning section~~ Revision to the versioning section in DCAT3 FPWD Mar 5, 2021

riccardoAlbertoni and others added 5 commits March 9, 2021 12:00

Merge branch 'gh-pages' into dcat-versioning-v2

8ba3cc8

Extend comparison with PROV in the versioning section

ba98eda

Replace dct: with dcterms:

7a94bdd

Merge branch 'gh-pages' into dcat-versioning-v2

213ca81

Editorial fixes

6ff43b0

agbeltran approved these changes Mar 10, 2021

View reviewed changes

andrea-perego merged commit 0cbbc79 into gh-pages Mar 10, 2021

DCAT Sprint: Versioning automation moved this from reviewer Approved to Done Mar 10, 2021

andrea-perego deleted the dcat-versioning-v2 branch March 10, 2021 19:30

This was linked to issues Mar 10, 2021

Should DCAT define a property for version identifiers? #1280

Closed

Should DCAT adopt of specific definition of versioning? #1277

Closed

"Current" vs "last" versions #1304

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Revision to the versioning section in DCAT3 FPWD #1295

Revision to the versioning section in DCAT3 FPWD #1295

andrea-perego commented Feb 13, 2021 •

edited

riccardoAlbertoni commented Feb 14, 2021

dr-shorthair commented Feb 16, 2021

dr-shorthair Feb 16, 2021

dr-shorthair Feb 16, 2021

andrea-perego Feb 16, 2021

dr-shorthair Feb 16, 2021 •

edited

dr-shorthair Feb 16, 2021

andrea-perego Feb 16, 2021

dr-shorthair Feb 16, 2021

andrea-perego commented Feb 16, 2021

griddigit commented Feb 16, 2021 via email •

edited by andrea-perego

riccardoAlbertoni commented Feb 17, 2021

andrea-perego commented Mar 5, 2021

andrea-perego commented Mar 10, 2021

agbeltran commented Mar 10, 2021

riccardoAlbertoni commented Mar 10, 2021

Revision to the versioning section in DCAT3 FPWD #1295

Revision to the versioning section in DCAT3 FPWD #1295

Conversation

andrea-perego commented Feb 13, 2021 • edited

riccardoAlbertoni commented Feb 14, 2021

dr-shorthair commented Feb 16, 2021

dr-shorthair Feb 16, 2021

Choose a reason for hiding this comment

dr-shorthair Feb 16, 2021

Choose a reason for hiding this comment

andrea-perego Feb 16, 2021

Choose a reason for hiding this comment

dr-shorthair Feb 16, 2021 • edited

Choose a reason for hiding this comment

dr-shorthair Feb 16, 2021

Choose a reason for hiding this comment

andrea-perego Feb 16, 2021

Choose a reason for hiding this comment

dr-shorthair Feb 16, 2021

Choose a reason for hiding this comment

andrea-perego commented Feb 16, 2021

griddigit commented Feb 16, 2021 via email • edited by andrea-perego

riccardoAlbertoni commented Feb 17, 2021

andrea-perego commented Mar 5, 2021

andrea-perego commented Mar 10, 2021

agbeltran commented Mar 10, 2021

riccardoAlbertoni commented Mar 10, 2021

andrea-perego commented Feb 13, 2021 •

edited

dr-shorthair Feb 16, 2021 •

edited

griddigit commented Feb 16, 2021 via email •

edited by andrea-perego