-
Notifications
You must be signed in to change notification settings - Fork 47
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Are we superseding DCAT 1 or not once DCAT 2 is a REC? #1177
Comments
The question for me is whether there is a strong incentive to move people from DCAT1 to DCAT2. In my mind, DCAT1 remains valid and if people don't have a need for the new bits in DCAT2 (e.g. Data Services, geo-stuff, time intervals, qualified relations, packaging etc.), they may not need to upgrade. |
The PID URI for DCAT, https://www.w3.org/TR/vocab-dcat/, now redirects to DCAT 2. It means it's now no-longer possible to find DCAT 1 online. Is this as intended? |
I'm leaning towards Makx view - perhaps with some nuances.
I wonder if a note could be added to DCAT 2014 explaining that it is a profile of DCAT? |
Apart from the DCAT 2014 document, @davebrowning does the NS document have a link to the old RDF representation? |
The draft updated NS document (which isn't published yet) does have a link to a copy of the old rdf -which it assumes is renamed dcat2014.rdf (as per the naming in github). Of course, we could make the "DCAT 2014 is a profile of DCAT" more explicit on that page. |
That's a surprise to me at this stage in the process, so I certainly didn't intend that. [You can get to DCAT1 from the PR, of course but that's a bit silly] . I'd assumed that that wouldn't happen, certainly not till final publication and after this conversation. Generally, I agree with the Makx/Simon approach, its just how we sign post that. (So I think that means we're not superceding.....) |
Maybe DCAT1 can be declared deprecated as soon as DCAT2 has become a Recommendation? |
@pwin said:
IMO, stating that DCAT2 supersedes DCAT1 should not be a big problem (as DCAT2 is backward compatible with DCAT1). Said that, I am perfectly happy also with the other proposal, outlined by @makxdekkers in #1177 (comment) I am more concerned about the issue reported by @nicholascar in #1177 (comment) :
I don't think this should be the right behaviour: the DCAT1 spec should be still accessible at its URL, and no redirection should be in place. |
Yes - the /TR/ URI for DCAT 2 is https://www.w3.org/TR/vocab-dcat-2/ |
So it looks like the redirect from https://www.w3.org/TR/vocab-dcat/ to https://www.w3.org/TR/vocab-dcat-2/ just needs to be broken and for https://www.w3.org/TR/vocab-dcat/ to have a note at the top as OWL Features does re OWL2: "New Version Available: OWL 2". There doesn't seem to be a status change from just plain Red in the OQL1 docs, just that note. |
I would in favour of "superseding" DCAT 2014. This, in my opinion, is not in contrast with Makx's view and does not force users to update, (I am afraid no one has such a strong power;)). Superseding DCAT 2014 do not remove DCAT 2014 from the web (the https://www.w3.org/TR/vocab-dcat/ remains available with a warning forwarding to the new specification), and the existing metadata descriptions which were compliant to DCAT 2014 will remain compliant to it. However, It is important to make clear that we recommend the new solutions provided by DCAT 2 for requirements that were not considered or were underrepresented in the previous DCAT, such as those related to Data Services, geo-stuff, time intervals, qualified relations, packaging etc. |
I agree with Andrea and Riccardo. Looking at the descriptions of the alternatives, it seems to be that "superseded" is what we're after. "W3C may obsolete a Recommendation, for example if the W3C Community decides that the Recommendation no longer represents best practices, or is not adopted and is not apparently likely to be adopted. An Obsolete Recommendation may be restored to normal Recommendation, for example because despite marking it Obsolete the specification is later more broadly adopted. W3C may declare a Recommendation Superseded if a newer version exists which the W3C recommends for new adoption. The process for declaring a Recommendation Superseded is the same as for declaring it Obsolete, below; only the name and explanation change. W3C may rescind a Recommendation if W3C believes there is no reasonable prospect of it being restored for example due to burdensome patent claims that affect implementers and cannot be resolved; see the W3C Patent Policy and in particular section 5 (bullet 10) and section 7.5." |
I've raised a separate issue for the DCAT 1 PID uri at #1182 |
I have mentioned to @plehegar that the consensus is to supercede version 1, and so we must now decide what text we include in version 1 to indicate this. https://www.w3.org/TR/2019/SPSD-WebCGM20-20191205/ is an example What are your thoughts about what information must be present? |
I agree with the comments by Riccardo and Andrea, also having read the points that Annette highlighted from https://www.w3.org/2019/Process-20190301/#rec-rescind, as superseding means that we would recommend to use DCAT2 for new adoption. I'd like to see some text clarifying that we are superseding but not making DCAT1 obsolete (as "A Recommendation can be both superseded and obsolete") and emphasise on the backward compatibility. I couldn't find anything around backward compatiblity in the Process Document either. The examples linked above don't seem to have any similar text, so we may need to write our own. |
Well I think the first note in the Proposed Rec goes in that direction, see below
Perhaps we might want to elaborate a little more on this, and move the note earlier in the document. For example, saying
|
I meant in the W3C Process Document (https://www.w3.org/2019/Process-20190301/#rec-rescind), not in the DCAT Proposed Rec About your text - here it goes again with a few changes in italics: "DCAT 2 supersedes DCAT [VOCAB-DCAT-20140116], but it does not make it obsolete. DCAT 2 maintains the DCAT namespace as its terms preserve backward compatibility with DCAT [VOCAB-DCAT-20140116]. DCAT 2 relaxes constraints and adds new classes and properties, but these changes do not break the definition of previous terms. Any new implementation is expected to adopt DCAT 2, while the existing implementations do not need to upgrade to it, unless they want to use the new features. In particular, current DCAT deployments that do not overlap with the DCAT 2 new features (e.g., data services, time and space properties qualified relations, packaging) don't need to change anything to remain in conformance with DCAT 2." What do you think? |
Looks good Alejandra
Perhaps we should also refer to the github issues and ask for a report
should anybody experience any difficulties with this
Cheers
Peter
…On Mon, 9 Dec 2019 at 18:01, Alejandra Gonzalez-Beltran < ***@***.***> wrote:
I couldn't find anything around backward compatiblity in the Process
Document either.
Well I think the first note in the Proposed Rec goes in that direction,
see below
DCAT 2 maintains the DCAT namespace as it preserves backward compatibility
with DCAT [VOCAB-DCAT-20140116]. DCAT 2 relaxes constraints and adds new
classes and properties, but these changes do not break existing DCAT
implementations.
I meant in the W3C Process Document (
https://www.w3.org/2019/Process-20190301/#rec-rescind), not in the DCAT
Proposed Rec
About your text - here it goes again with a few changes in italics:
"DCAT 2 supersedes DCAT [VOCAB-DCAT-20140116], *but it does not make it
obsolete*. DCAT 2 maintains the DCAT namespace as its terms preserve
backward compatibility with DCAT [VOCAB-DCAT-20140116]. DCAT 2 relaxes
constraints and adds new classes and properties, but these changes do not
break the definition of previous terms.
Any new implementation is expected to adopt DCAT 2, while the existing
implementations *do not* need to upgrade to it, *unless they want to use
the new features*. In particular, current DCAT deployments that do not
overlap with the DCAT 2 new features (e.g., data services, time and space
properties qualified relations, packaging) don't need to change anything to
remain in conformance with DCAT 2."
What do you think?
—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
<#1177?email_source=notifications&email_token=AAIFYTDCIKALF6FPL7C32S3QX2BXRA5CNFSM4JRAMA3KYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEGKCRRI#issuecomment-563357893>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAIFYTHIPEDZNJI6FITIMWLQX2BXRANCNFSM4JRAMA3A>
.
|
@agbeltran wrote
I like it. Let's consider an existing implementation in which a SPARQL endpoint is described in the old fashion DCAT style as embedded in a distribution instead of the DCAT 2 data service. My opinion is that, in cases like the above, we should encourage to follow DCAT2 and then recommend to upgrade to DCAT 2 data service, while the sentence seems to leave this slightly open. I guess that being DCAT 2014 not obsolete, the user can decide anyway not to stick to DCAT 2014, but he/she should be aware that this comes at the cost of being uncompliant with DCAT2. Perhaps we might change "if they want to use the new feature." in "if they need to use the new features."? |
@riccardoAlbertoni @agbeltran & all, I like Alejandra's version better, with the want instead of the need. By the way, I find @plehegar's examples very confusing:
So, no best practice there. I think W3C needs a clear policy for linking old and new recommendations. |
As I see it, documents published in the process of developing and maintaining evergreen recommendations take part in two chains:
Both chains need to be reflected in a very clear way in the document metadata of every document in either chain. In the REC chain there are several possible relationships between subsequent RECs:
These relationships could maybe be expressed with a controlled status vocabulary: under development, completed, superseded, deprecated, withdrawn etc. How can we develop such a policy? |
Ok, let's keep Alejandra's revision, probably we cannot explain everything in once, and anyway, other parts of the document solves the concerns related to the example I was making. |
Alejandra's revision is now merged in the document. Is there any other activity we need to accomplish before closing this issue? |
are we clear on what modifications we want to make to the DCAT 1 REC, if any? |
I don't think we can or should make changes in DCAT1. But the version delivered by W3C should make it clear that it has been superseded - e.g. see what happens when you get https://www.w3.org/TR/2006/WD-owl-time-20060927/ |
I concur with @dr-shorthair . I would also like to mention that, in SpecRef, the key "VOCAB-DCAT" still returns the bib reference about the original version of DCAT. The fact that the URL included there (https://www.w3.org/TR/vocab-dcat/) points to DCAT2 is confusing for people. See https://api.specref.org/bibrefs?refs=VOCAB-DCAT: {
"VOCAB-DCAT": {
"aliasOf": "vocab-dcat",
"id": "VOCAB-DCAT"
},
"vocab-dcat": {
"authors": [
"Fadi Maali",
"John Erickson"
],
"href": "https://www.w3.org/TR/vocab-dcat/",
"title": "Data Catalog Vocabulary (DCAT)",
"status": "REC",
"publisher": "W3C",
"deliveredBy": [
{
"url": "https://www.w3.org/2011/gld/",
"shortname": "gld"
}
],
"versions": [
"vocab-dcat-20140116",
"vocab-dcat-20131217",
"vocab-dcat-20131105",
"vocab-dcat-20130801",
"vocab-dcat-20130312",
"vocab-dcat-20120405"
],
"id": "vocab-dcat",
"date": "16 January 2014"
}
} |
@andrea-perego If I understand your point, you would like to have a URL consistent with this (i.e., the DCAT URL https://www.w3.org/TR/vocab-dcat-2/ instead of https://www.w3.org/TR/vocab-dcat/). Or you were suggesting something else? |
I think that what @andrea-perego is pointing out would be solved by changing the href in https://api.specref.org/bibrefs?refs=VOCAB-DCAT to the specific DCAT 1 URL: https://www.w3.org/TR/2014/REC-vocab-dcat-20140116/ At the moment the href for "VOCAB-DCAT" is pointing to https://www.w3.org/TR/vocab-dcat/, which will always be the latest DCAT rather than the specific version one wants to point to. |
Thanks, @agbeltran . Yes, that would be an option. But, actually, I was not pointing to a specific solution - just reporting an inconsistency. If VOCAB-DCAT should always refer to the latest version, this needs to be reflected in the corresponding bib entry in SpecRef, I guess, Of course, this will have a negative side effect in existing specifications using that key / URL to point specifically to DCAT 2014, |
Yes, @andrea-perego the inconsistency is unfortunate. But given that specs might have used VOCAB-DCAT and we won't want to break them, I am not sure if we could use the biblio reference VOCAB-DCAT for the latest version, but we will have to make sure it points to DCAT1. Perhaps we should have an alternative key for the latest spec (e.g. VOCAB-DCAT-LATEST), even though it won't match the 'vocab-dcat' in the URL |
@agbeltran wrote:
It seems that the VOCAB-DCAT-LATEST is already foreseen and corresponds to https://www.w3.org/TR/dcat-voc/latest in the slides mentioned by Philippe, see also https://github.com/w3c/tr-pages/wiki/Latest-versions-proposal-for-leveled-specifications. However, I haven't found a correspondent bib entry for https://www.w3.org/TR/dcat-voc/latest |
To get to a point with this issue, I would concur with @agbeltran's and @dr-shorthair's suggestions combined. @dr-shorthair wrote:
@agbeltran wrote:
That's what we can have according to the previous comments, and it does not break previous citations. |
I agree with that approach. Additionally, we should try to get VOCAB-DCAT-LATEST into the bibliography replacing the current VOCAB-DCAT |
I think vocab-dcat-latest should not be used as a bibliographic entry as it is going to change any time a new rec version is out .. |
https://www.w3.org/TR/vocab-dcat/ always points to the latest spec, so VOCAB-DCAT-LATEST should include that href - as per comments above |
I think that, whatever the solution is/will be, this is not going to apply only to DCAT but to all TRs - as far as I know, so far citation keys always correspond to the last part of the URI, so I guess this is not going to change. @plehegar , could you shed some light on this? |
Re https://api.specref.org/bibrefs?refs=VOCAB-DCAT , there is currently a bug in the W3C API See w3c/w3c-api#96 . Once the bug gets fixed, it will match https://www.w3.org/TR/vocab-dcat/ , and respec will point to the same place. |
This issue is on the hand of W3C, and we can't do much on it. However, I think we might want to recheck how URL links and bibliographic refs work after DCAT 2 rec is published. |
SGTM. our webmaster is working on resolving the issue. I doubt it will get fixed by Jan 31 but hoping shortly after. |
@riccardoAlbertoni if this is being handled, I agree with moving it to the "future work" milestone and deal with it after DCAT2 REC is public. |
+1 from me as well. |
https://www.w3.org/TR/vocab-dcat-1/ is now officially superseded. I propose to close this issue. Note that the API bug remains (mismatch between /TR and API for "vocab-dcat"). If we want to track w3c/w3c-api#96 , we could open a separate issue in this repo. |
There is a status of recommendation document - "Recommendation Superceded" which is described at https://www.w3.org/2019/Process-20190301/#rec-rescind [there is interesting discussion about this at https://github.com/w3c/process/issues/36 ]
Please can we discuss here. Do we want to supercede DCAT v1?
The text was updated successfully, but these errors were encountered: