[dxwg] Minor editorial comments on DCAT CR candidate (#1020)

larsgsvensson has just created a new issue for https://github.com/w3c/dxwg:

== Minor editorial comments on DCAT CR candidate ==
First of all: Kudos to the editors! The CR candidate is a great piece of work.

Minor nits:

1. [4. Conformance](https://w3c.github.io/dxwg/dcat/#conformance): The last bullet point in the list of conformance criteria reads very differently from the other ones.
> A data catalog conforms to DCAT if:
* DCAT-compliant catalogs MAY include additional ...

I propose to take that bullet point out of the list, like
> * All classes and properties defined in DCAT are used in a way consistent with the semantics declared in this specification.
DCAT-compliant catalogs MAY include additional non-DCAT metadata fields and additional RDF data in the catalog's RDF description.

2. [4. Conformance](https://w3c.github.io/dxwg/dcat/#conformance): I think it would be helpful to implementers to explicitly specify which URI to use to indicate that a catalogue conforms do DCAT 2. Would
```
my:catalogue dct:conformsTo <https://www.w3.org/TR/vocab-dcat/>
```
be correct?

3. Figure 1: The relation `dcat:record` from `dcat:Catalog` to `dcat:CatalogRecord` has the cardinality `1..n`. Shouldn't that be `0..n`? (Otherwise it would be mandatory to have at least one catalogue record, while the [usage note for `dcat:CatalogRecord`](https://w3c.github.io/dxwg/dcat/#Class:Catalog_Record) explicitly says: "This class is optional and not all catalogs will use it."

4. In [§6.3.2 Property: themes](https://w3c.github.io/dxwg/dcat/#Property:catalog_themes), the usage notes has a hyphen in "linked-data". This is the only place where this term is hyphenised; all other occurences spell it "linked data".

5. In the definition of [§6.3.6 Property: catalo](https://w3c.github.io/dxwg/dcat/#Property:catalog_catalog), there is no period/full stop at the end of the sentence (the other definitions have one).

6. In the second usage note of [§6.4 Class: Cataloged Resource](https://w3c.github.io/dxwg/dcat/#Class:Resource), there is no period/full stop at the end of the sentence (the other usage notes have one).

7. In [Example 36](https://w3c.github.io/dxwg/dcat/#ex-conformance-degree-percentage), I think that `iso:inherentandSystemDependentDataQuality a dqv:Category ;` should read `iso:inherentAndSystemDependentDataQuality a dqv:Category ;` (inherent __And__ System Dependent ...)

8. In [Example 40](https://w3c.github.io/dxwg/dcat/#ex-conformance-test-error) you use `dc:format "text/xml"`. I don't think we should point people to deprecated media types and propose to use `dc:format "application/xml"` instead.
And I think there is a comma missing in the last sentence of [§12.2.3](https://w3c.github.io/dxwg/dcat/#quality-conformance-test-results): It currently reads "Of course, the above modelling patterns can represent any quality tests not only conformance to standards." I think that should be "Of course, the above modelling patterns can represent any quality tests**,** not only conformance to standards."

9. In the Note at the end of [§13](https://w3c.github.io/dxwg/dcat/#qualified-forms), there either is an "s" too many in "the context resources is a member", should read "the context resource is a member".

10. In the references section you point [DCAT-AP.de] to https://govdata.de/standardisierung. I think the canonical reference to the spec is https://dcat-ap.de/def/.

Please view or discuss this issue at https://github.com/w3c/dxwg/issues/1020 using your GitHub account

Received on Monday, 29 July 2019 13:57:01 UTC