[dxwg] Editorial comments on DCAT ED (#922)

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

== Editorial comments on DCAT ED ==
Having read the DCAT ED I stumbled over some minor(?) editorial issues:
* In the last part of the abstract it says "The (revised) DCAT vocabulary is available _here_." IIRC hyperlinks with the text "here" are considered a Bad Practice (TM). Suggestion "There is a _Turtle version of the (revised) DCAT vocabulary_ available".
* In the [section on Namespaces](https://w3c.github.io/dxwg/dcat/#namespaces) there is a reference to `dc:`. In the document `dc:` is only used in [example 19](https://w3c.github.io/dxwg/dcat/#ex-genoa-bus-stops-dataset-completeness-note), [example 28](https://w3c.github.io/dxwg/dcat/#ex-conformance-test-error) and in the [definition of `dct:type`](https://w3c.github.io/dxwg/dcat/#Property:resource_type) (and there only for the `rdfs:subClassOf` axiom). I suggest to get rid of `dc:` and only use `dct:`, particularly since none of the other `dct:` property descriptions highlight the subclass axiom.
* In [ยง5.1](https://w3c.github.io/dxwg/dcat/#dcat-scope) there is a note after the UML diagram saying that "Cardinalities are shown in a few places to reinforce expectations, but these are not axiomatized or enforced in any way by this recommendation". This is not entirely true, since the ttl file declares cardinalities for the use of `dct:relation` on `dcat:Relationship` and `dct:type` on `dcat:Resource`.
* Just above [Example 4](https://w3c.github.io/dxwg/dcat/#ex-distribution) the text says "a 5Kb CSV file". Should that be "a 5 kB CSV file"? (minor k for prefix kilo)
* The [scope note for `dcat:byteSize`](https://w3c.github.io/dxwg/dcat/#Property:distribution_size) says "The size in bytes can be approximated when the precise size is not known." I think it would avoid possible errors if we highlighted that even if the size is approximated, it still must be a decimal number, i. e. if the true size is 2,912 bytes, we can approximate with `"3000"^^xsd:decimal` but not with `"3k"^^xsd:decimal`.
* Minor type in the usage note for [spatial resolution](https://w3c.github.io/dxwg/dcat/#Property:dataset_spatialresolution): "For other kinds of spatial dataset," should probably be "For other kinds of spatial datasets,"
* [`dcat:compressFormat`](https://w3c.github.io/dxwg/dcat/#Property:distribution_compression_format) and [`dcat:packageFormat`](https://w3c.github.io/dxwg/dcat/#Property:distribution_packaging_format): There is no note that those were added during the revision.
* [`dcat:Role`](https://w3c.github.io/dxwg/dcat/#Class:Role): The note says that the property was newly added, but `dcat:Role` is a class...
* Are the sections on [Qualified Relations](https://w3c.github.io/dxwg/dcat/#qualified-forms), [License and rights statements](https://w3c.github.io/dxwg/dcat/#license-rights), [Versioning](https://w3c.github.io/dxwg/dcat/#dataset-versions) and [DCAT Profiles](https://w3c.github.io/dxwg/dcat/#profiles) really all normative? They do not say _non-normative_ so by reverse conclusion they are...

If you agree with those, I'd be happy to prepare a PR.

And: **Great Work**

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

Received on Wednesday, 8 May 2019 14:35:14 UTC