Dxwg: dcat:compressFormat and dcat:packageFormat description inconsistency

Created on 16 May 2019  路  6Comments  路  Source: w3c/dxwg

In dcat:compressFormat, there is:

dcat:compressFormat
  rdfs:comment "The format of the distribution in...

In dcat:packageFormat, there is:

dcat:packageFormat
  rdfs:comment "The format of the file ...

The question is which one is correct, but it should be only one of them. I would vote for "file".

Editorial dcat feedback

Most helpful comment

I agree that 'file' definitely makes sense, but given that the domain of the properties is dcat:Distribution I wonder if we are not causing confusion by only saying file. I note that the specification uses 'file' in both cases too.

However, we have a whole section of examples of compressed and packaged distributions: https://w3c.github.io/dxwg/dcat/#examples-compressed-and-packaged-distributions

And also when we talk about format, we mention the file format of the distribution: https://w3c.github.io/dxwg/dcat/#Property:distribution_format

So, what about saying the 'compression format of the distribution' and the 'package format of the distribution' to be consistent across the document and with the domain of the property?

All 6 comments

I agree that both should refer to 'file'.

I agree that 'file' definitely makes sense, but given that the domain of the properties is dcat:Distribution I wonder if we are not causing confusion by only saying file. I note that the specification uses 'file' in both cases too.

However, we have a whole section of examples of compressed and packaged distributions: https://w3c.github.io/dxwg/dcat/#examples-compressed-and-packaged-distributions

And also when we talk about format, we mention the file format of the distribution: https://w3c.github.io/dxwg/dcat/#Property:distribution_format

So, what about saying the 'compression format of the distribution' and the 'package format of the distribution' to be consistent across the document and with the domain of the property?

We discussed this today and there was agreement on using 'distribution' for consistency - https://www.w3.org/2019/07/10-dxwgdcat-minutes.html

BTW, the changes should be made in both spec and ttl file. We also discussed on the option of adding a skos:usageNote where we clarify that in many cases the distribution will be a file.

... We also discussed on the option of adding a skos:usageNote where we clarify that in many cases the distribution will be a file.

Rereading the usage notes we have for dcat:packageFormat and dcat:compressFormat (see below) I think this is already quite explicit.

dcat:packageFormat Usage Note:

This property to be used when the files in the distribution are packaged, e.g. in a TAR file. The format SHOULD be expressed using a media type as defined by IANA [[!IANA-MEDIA-TYPES]], if available.

dcat:compressFormat Usage Note:

This property to be used when the files in the distribution are compressed, e.g. in a ZIP file. The format SHOULD be expressed using a media type as defined by IANA [[!IANA-MEDIA-TYPES]], if available.

Agreed - then we don't need to add anything else.

Was this page helpful?
0 / 5 - 0 ratings