w3c / dxwg

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

Fix inconsistent use of "item" and "resource" #1491

Closed andrea-perego closed 2 years ago

andrea-perego commented 2 years ago

Implementing proposal in https://github.com/w3c/dxwg/issues/1490

Summary of changes:

Preview: https://raw.githack.com/w3c/dxwg/dcat-issue-1490/dcat/index.html

Diff: https://services.w3.org/htmldiff?doc1=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fdxwg%2Fdcat-ex-record-schema%2Fdcat%2Findex.html&doc2=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fdxwg%2Fdcat-issue-1490%2Fdcat%2Findex.html

andrea-perego commented 2 years ago
  • Replaced "item" with "resource" when referring to an instance of dcat:Resource

For our records:

This revision affects definitions and/or usage notes of the following terms under §6.4 Class: Cataloged Resource:

dcterms:description - §6.4.5 Property: description

Current defintion:

A free-text account of the item.

Revised definition:

A free-text account of the resource.

dcterms:title - §6.4.6 Property: title

Current defintion:

A name given to the item.

Revised definition:

A name given to the resource.

dcterms:issued - §6.4.7 Property: release date

Current defintion:

Date of formal issuance (e.g., publication) of the item.

Revised definition:

Date of formal issuance (e.g., publication) of the resource.

dcterms:modified - §6.4.8 Property: update/modification date

Current defintion:

Most recent date on which the item was changed, updated or modified.

Revised definition:

Most recent date on which the resource was changed, updated or modified.

Current usage note:

The value of this property indicates a change to the actual item, not a change to the catalog record. An absent value MAY indicate that the item has never changed after its initial publication, or that the date of last modification is not known, or that the item is continuously updated.

Revised usage note:

The value of this property indicates a change to the actual resource, not a change to the catalog record. An absent value MAY indicate that the resource has never changed after its initial publication, or that the date of last modification is not known, or that the resource is continuously updated.

dcterms:language - §6.4.9 Property: language

Current definition:

A language of the item. This refers to the natural language used for textual metadata (i.e. titles, descriptions, etc) of a cataloged resource (i.e. dataset or service) or the textual values of a dataset distribution

Revised definition:

A language of the resource. This refers to the natural language used for textual metadata (i.e. titles, descriptions, etc) of a cataloged resource (i.e. dataset or service) or the textual values of a dataset distribution

dcterms:publisher - §6.4.10 Property: publisher

Current definition:

The entity responsible for making the item available.

Revised definition:

The entity responsible for making the resource available.

dcterms:identifier - §6.4.11 Property: identifier

Current usage note 1:

The identifier might be used as part of the IRI of the item, but still having it represented explicitly is useful.

Revised usage note 1:

The identifier might be used as part of the IRI of the resource, but still having it represented explicitly is useful.

dcterms:relation - §6.4.14 Property: relation

Current definition:

A resource with an unspecified relationship to the cataloged item.

Revised definition:

A resource with an unspecified relationship to the cataloged resource.

Current usage note:

dcterms:relation SHOULD be used where the nature of the relationship between a cataloged item and related resources is not known. A more specific sub-property SHOULD be used if the nature of the relationship of the link is known. The property dcat:distribution SHOULD be used to link from a dcat:Dataset to a representation of the dataset, described as a dcat:Distribution

Revised usage note:

dcterms:relation SHOULD be used where the nature of the relationship between a cataloged resource and related resources is not known. A more specific sub-property SHOULD be used if the nature of the relationship of the link is known. The property dcat:distribution SHOULD be used to link from a dcat:Dataset to a representation of the dataset, described as a dcat:Distribution