Re: [dxwg] Tracking the API bug (mismatch between /TR and API for "vocab-dcat") (#1223)

@pchampin said:

> @andrea-perego sorry for letting this linger for so long.
> 
> Let me try to summarize our findings so fat:
> 
> * on w3.org/TR, [`vocab-dcat`](https://www.w3.org/TR/vocab-dcat/) (without any version number) points to the _latest_ REC (currently `vocab-dcat-2`),
> * wheras on specref, all the fields of  [`vocab-dcat`](https://api.specref.org/bibrefs?refs=vocab-dcat) are describing the _first_ version of DCAT, except for `href` which is pointing to the "versionless" URL https://www.w3.org/TR/vocab-dcat/ .
> 
> So we have two issues:
> 
> * specref is not self-consistent in the description of version-less specs ([`vocab-dcat`](https://api.specref.org/bibrefs?refs=vocab-dcat), but also [`json-ld`](https://api.specref.org/bibrefs?refs=json-ld), and possibly others)
> * specref is inconsistent with TR when it comes to version-less names
> 
> Do we agree?

Yes, but with a difference:

> * on w3.org/TR, [`vocab-dcat`](https://www.w3.org/TR/vocab-dcat/) (without any version number) points to the _latest_ REC (currently `vocab-dcat-2`),
> * wheras on specref, all the fields of  [`vocab-dcat`](https://api.specref.org/bibrefs?refs=vocab-dcat) are describing the _first_ version of DCAT, except for `href` which is pointing to the "versionless" URL https://www.w3.org/TR/vocab-dcat/ .

and except for `rawDate`, which corresponds to the one of the latest REC (`2020-02-04`).

This is the record for `vocab-dcat` in SpecRef (https://github.com/tobie/specref/blob/main/refs/w3c.json):

````json
    "vocab-dcat": {
        "authors": [
            "Fadi Maali",
            "John Erickson"
        ],
        "href": "https://www.w3.org/TR/vocab-dcat/",
        "title": "Data Catalog Vocabulary (DCAT)",
        "rawDate": "2020-02-04",
        "status": "REC",
        "publisher": "W3C",
        "deliveredBy": [
            "https://www.w3.org/2011/gld/"
        ],
        "source": "https://www.w3.org/2002/01/tr-automation/tr.rdf",
        "versions": {
          ...
        },
        "isRetired": true,
        "obsoletedBy": [
            "vocab-dcat-2"
        ]
    },
````

which should be modified as follows:

````diff
    "vocab-dcat": {
        "authors": [
-            "Fadi Maali",
-            "John Erickson"
+            "Riccardo Albertoni",
+            "David Browning",
+            "Simon Cox",
+            "Alejandra Gonzalez Beltran",
+            "Andrea Perego",
+            "Peter Winstanley"
        ],
        "href": "https://www.w3.org/TR/vocab-dcat/",
-        "title": "Data Catalog Vocabulary (DCAT)",
+        "title": "Data Catalog Vocabulary (DCAT) - Version 2",
        "rawDate": "2020-02-04",
        "status": "REC",
        "publisher": "W3C",
        "deliveredBy": [
-            "https://www.w3.org/2011/gld/"
+            "https://www.w3.org/2017/dxwg/"
        ],
        "source": "https://www.w3.org/2002/01/tr-automation/tr.rdf",
        "versions": {
          ...
        },
-        "isRetired": true,
-        "obsoletedBy": [
-            "vocab-dcat-2"
-        ]
    },
````

Besides this, also the `versions` array should be modified for `vocab-dcat`. 

Currently, the record in SpecRef lists as versions all the versions of `vocab-dcat-1` until REC. However, if `vocab-dcat` is meant to return only the latest REC, its versions should be instead `vocab-dcat-1` and `vocab-dcat-2`.

So, it should be something like

````json
        "versions": {
          "20140116" : {
            "aliasOf": "vocab-dcat-1"
          },
          "20200204" : {
            "aliasOf": "vocab-dcat-2"
          }
        }
````

-- 
GitHub Notification of comment by andrea-perego
Please view or discuss this issue at https://github.com/w3c/dxwg/issues/1223#issuecomment-2025094024 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Thursday, 28 March 2024 12:41:00 UTC