w3c / dxwg

Data Catalog Vocabulary (DCAT)
https://w3c.github.io/dxwg/dcat/
Other
139 stars 55 forks source link

Domain, range and usage of dcat:first, dcat:last is hard to understand #1513

Closed stigbd closed 1 year ago

stigbd commented 2 years ago

In an early attempt to use the much welcomed dcat:DatasetSeries in our Norwegian application profile DCAT-AP-NO, I find it hard to understand how dcat:first and dcat:last is to be used.

None of the examples show the usage of these properties.

Based on the assumption that domain/range is dcat:DatasetSeries/dcat:Dataset and what I think is the intention behind these properties, this should work as an example:

ex:EUCatalogue a dcat:Catalog ;
  dcterms:title "European Data Catalogue"@en ;
  dcat:dataset ex:budget  ;
  .

ex:budget a dcat:DatasetSeries ;
  dcterms:title "Budget data"@en ;
  dcat:first ex:budget-2018 ;
  dcat:last ex:budget-2020 ;
  .

ex:budget-2018 a dcat:Dataset ;
  dcterms:title "Budget data for year 2018"@en ;
  dcat:inSeries ex:budget ;
  dcterms:issued "2019-01-01"^^xsd:date ;
  dcat:next ex:budget-2019 ;
  .

ex:budget-2019 a dcat:Dataset ;
  dcterms:title "Budget data for year 2019"@en ;
  dcat:inSeries ex:budget ;
  dcterms:issued "2020-01-01"^^xsd:date ;
  dcat:prev ex:budget-2018 ;
  dcat:next ex:budget-2020 ;
  .

ex:budget-2020 a dcat:Dataset ;
  dcterms:title "Budget data for year 2020"@en ;
  dcat:inSeries ex:budget ;
  dcterms:issued "2021-01-01"^^xsd:date ;
  dcat:prev ex:budget-2019 ;
  .

I suggest you include domain, range and an example showing the usage of these properties.

riccardoAlbertoni commented 1 year ago

Thanks, @stigbd, for your comments. PR #1516 includes dcat:first and dcat:last in some examples of the current editorial draft.

We didn't restrict the range and domain as these properties might also help in more general use cases. In fact, for the sake of generality, they have been defined at the level of dcat:Resources.

I suggest closing this issue if you don't have any other comments.

stigbd commented 1 year ago

The additions to the examples look good to me. Thanks for adressing this!