DCAT Issue 702 - Added ? to all refs not explicitly marked as normative #719

andrea-perego · 2019-01-30T22:44:37Z

Trying to address #702 , and following the relevant discussion in today's (30 Jan 2019) DCAT subgroup meeting:

https://www.w3.org/2019/01/30-dxwgdcat-minutes (go to the end)

Preview here: https://rawgit.com/w3c/dxwg/andrea-perego-fix-to-refs/dcat/index.html#references

dr-shorthair · 2019-01-30T23:00:07Z

dcat/index.html


    <p>
        The detailed differences between the two documents can be seen <a href="https://services.w3.org/htmldiff?doc1=https%3A%2F%2Fwww.w3.org%2FTR%2F2018%2FWD-vocab-dcat-2-20180508%2F&doc2=https%3A%2F%2Fwww.w3.org%2FTR%2F2018%2FWD-vocab-dcat-2-20181011%2F">here</a>
        and the list of all the changes since the previous version of DCAT in the <a href="#changes">Change History</a> section.
    </p>

    <h3 id="dcat_history">DCAT history</h3>
-    <p>The original DCAT vocabulary was developed and <a href="http://vocab.deri.ie/dcat">hosted</a> at the Digital Enterprise Research Institute (DERI), then refined by the <a href="http://www.w3.org/egov/">eGov Interest Group</a>, and finally standardized in 2014 [[VOCAB-DCAT-20140116]] by the <a href="http://www.w3.org/2011/gld/">Government Linked Data (GLD)</a> Working Group.</p>
-    <p>This revised version of DCAT was developed by the <a href="https://www.w3.org/2017/dxwg/">Dataset Exchange Working Group</a> in response to a new set of Use Cases and Requirements [[DCAT-UCR]] submitted on the basis of experience with the DCAT vocabulary from the time of the original version, and new applications not originally considered. A summary of the changes from  [[VOCAB-DCAT-20140116]] can be found at <a href="#changes">Change History</a></p>
+    <p>The original DCAT vocabulary was developed and <a href="http://vocab.deri.ie/dcat">hosted</a> at the Digital Enterprise Research Institute (DERI), then refined by the <a href="http://www.w3.org/egov/">eGov Interest Group</a>, and finally standardized in 2014 [[?VOCAB-DCAT-20140116]] by the <a href="http://www.w3.org/2011/gld/">Government Linked Data (GLD)</a> Working Group.</p>


Should this one be normative?

So probably no ? or !, here, but add a mention in a normative section.

Exactly. But the ? can be kept. If a ref is included only once in a normative section, it will end up in the "normative references" section only, even though elsewhere is marked as non-normative.

i.e. no point in adding a ? or a ! to anything in an informative section. The only case that is significant is to downgrade to a ? within a normative section.

(That case was the one that I was fighting in the case of LDP but I guess I just got it wrong?)

It appears that there is also a rule that references in a context with class="note" are informative by default, but can be promoted to normative with a !

Could you put class="informative" on the element for a non rec-track document, like UCR?

I guess so.

It appears that there is also a rule that references in a context with class="note" are informative by default, but can be promoted to normative with a !

Good to know

Actually now I'm not sure if DCAT-2014 should be a normative ref, as it is the document that this one supersedes. Probably not - DCAT-2014 is an important part of the provenance, but will be replaced in-place by this one and the RDF implementation (which is in dcat.ttl) ...

Reverted DCAT-2014 to non-normative ref

dr-shorthair · 2019-01-30T23:00:49Z

dcat/index.html

    </p>

    <p>
      This document does not prescribe any particular method of deploying data expressed in DCAT.
-      DCAT is applicable in many contexts including RDF accessible via SPARQL endpoints, embedded in HTML pages as RDFa, or serialized as e.g. RDF/XML, N3, Turtle, or JSON-LD.
+      DCAT is applicable in many contexts including RDF accessible via SPARQL endpoints, embedded in HTML pages as [[?HTML-RDFa]], or serialized as e.g. RDF/XML [[?RDF-SYNTAX-GRAMMAR]], [[?N3]], [[?Turtle]], or [[?JSON-LD]].


Hmm. Again - I'd expect these to be normative

I tried to make them as normative, but then I got an error from ReSpec saying normative refs cannot be in informative sections.

Ah - OK. Yes, I guess that makes sense.

OK - I added a little material on DCAT 2014 to a normative section.

dr-shorthair · 2019-01-30T23:01:35Z

dcat/index.html

        Locally defined elements are in the namespace <a href="http://www.w3.org/ns/dcat#">http://www.w3.org/ns/dcat#</a>.
-        Elements are also adopted from several external vocabularies, in particular [[FOAF]], [[DCTERMS]] and [[PROV-O]]
+        Elements are also adopted from several external vocabularies, in particular [[?FOAF]], [[?DCTERMS]] and [[?PROV-O]]


I guess I'm misunderstanding here - all these should be normative refs. I thought that implied a ! not a ?

+1 from me.

Sorry, but this first try of mine was not meant to determine what was normative or not, but just to see if putting the ? would have achieved the expected result. As I said above, I actually started trying to make some refs normative, but I got that error from ReSpec, so I gave up.

BTW, @dr-shorthair , please note that some refs above (as FOAF), are ending up in the "normative references" section, as they were marked as such in one of the normative sections.

You can see the result here:

https://rawgit.com/w3c/dxwg/andrea-perego-fix-to-refs/dcat/index.html#references

See #702 (comment)

…rial on use of elements from external vocabularies to be moved to a normative section.

# Conflicts: # dcat/index.html

…replaced by this rec)

agbeltran · 2019-02-05T18:26:11Z

I've fixed a few conflicts in this PR, and now checking the diff with ED, I see that it has a list of properties in dcat:Catalog that actually correspond to the superclasses and should not be listed.

https://services.w3.org/htmldiff?doc1=http%3A%2F%2Fw3c.github.io%2Fdxwg%2Fdcat%2F&doc2=https%3A%2F%2Frawgit.com%2Fw3c%2Fdxwg%2Fandrea-perego-fix-to-refs%2Fdcat%2Findex.html%23Class%3ACatalog

I suspect this is due to some removal in another PR. Will remove them and then merge.

andrea-perego · 2019-02-05T21:10:55Z

Thanks, @dr-shorthair & @agbeltran . Just noting that ReSpec complains about one normative ref in a non-normative section:

https://w3c.github.io/dxwg/dcat/#respec-offender-normative-references-in-informative-sections-are-not-allowed-remove-from-the-start-of-the-reference-dwbp

Added ? to all refs not explicitly marked as normative

ee072cb

andrea-perego added dcat Editorial labels Jan 30, 2019

andrea-perego requested a review from dr-shorthair January 30, 2019 22:44

andrea-perego added this to To do in DCAT revision via automation Jan 30, 2019

andrea-perego mentioned this pull request Jan 30, 2019

DCAT: Check normative references #702

Closed

dr-shorthair reviewed Jan 30, 2019

View reviewed changes

Simon Cox added 3 commits January 31, 2019 16:42

Flipped some refs from non-normative to normative. Required some mate…

db2d851

…rial on use of elements from external vocabularies to be moved to a normative section.

Remove duplicate

97f71cf

W3C Notes cannot be normatively referenced

b9dfa60

dr-shorthair changed the title ~~Added ? to all refs not explicitly marked as normative~~ DCAT Issue 702 - Added ? to all refs not explicitly marked as normative Jan 31, 2019

Simon Cox and others added 4 commits February 1, 2019 16:45

Merge branch 'gh-pages' into andrea-perego-fix-to-refs

f329ed5

# Conflicts: # dcat/index.html

DCAT-2014 a non-normative reference (yes it is provenance, but it is …

0c827d3

…replaced by this rec)

Merge branch 'gh-pages' into andrea-perego-fix-to-refs

13391f8

Merge branch 'gh-pages' into andrea-perego-fix-to-refs

132a35d

agbeltran added this to the DCAT Third Public Working Draft milestone Feb 5, 2019

Removing details of inherited properties for dcat:Catalog

4faae49

dr-shorthair approved these changes Feb 5, 2019

View reviewed changes

dr-shorthair merged commit 0feec87 into gh-pages Feb 5, 2019

DCAT revision automation moved this from To do to Done Feb 5, 2019

dr-shorthair deleted the andrea-perego-fix-to-refs branch February 5, 2019 19:31

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

DCAT Issue 702 - Added ? to all refs not explicitly marked as normative #719

DCAT Issue 702 - Added ? to all refs not explicitly marked as normative #719

andrea-perego commented Jan 30, 2019 •

edited

Loading

dr-shorthair Jan 30, 2019

andrea-perego Jan 30, 2019

dr-shorthair Jan 30, 2019

andrea-perego Jan 30, 2019

dr-shorthair Jan 30, 2019

dr-shorthair Jan 31, 2019

andrea-perego Jan 31, 2019

andrea-perego Jan 31, 2019

dr-shorthair Feb 1, 2019

dr-shorthair Feb 1, 2019

dr-shorthair Jan 30, 2019

andrea-perego Jan 30, 2019

dr-shorthair Jan 30, 2019

dr-shorthair Jan 31, 2019

dr-shorthair Jan 30, 2019

andrea-perego Jan 30, 2019

andrea-perego Jan 30, 2019 •

edited

Loading

dr-shorthair Jan 30, 2019

agbeltran commented Feb 5, 2019

andrea-perego commented Feb 5, 2019

DCAT Issue 702 - Added ? to all refs not explicitly marked as normative #719

DCAT Issue 702 - Added ? to all refs not explicitly marked as normative #719

Conversation

andrea-perego commented Jan 30, 2019 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

andrea-perego Jan 30, 2019 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

agbeltran commented Feb 5, 2019

andrea-perego commented Feb 5, 2019

andrea-perego commented Jan 30, 2019 •

edited

Loading

andrea-perego Jan 30, 2019 •

edited

Loading