admin icon indicating copy to clipboard operation
admin copied to clipboard

biblio.json file not updated in two years

Open tabatkins opened this issue 1 year ago β€’ 3 comments

Currently, SpecRef relies on this repo's biblio.json file for its WICG references. Is this still meant to be up-to-date? If so, did an automatic process fall over, or did the manual updater person let it fall off their plate?

Alternately, should SpecRef be referring to something different, maybe WebRef? If so, we should retire this biblio.json file so nobody accidentally depends on it.

tabatkins avatar May 30 '24 17:05 tabatkins

Yeah, I think it’s always been manually maintained (by random folks in the community). I wonder if we should deprecate it, specially if we can get the same (or better) data from WebRef.

marcoscaceres avatar Jun 05 '24 10:06 marcoscaceres

Oh, I hadn't seen this issue. Specref already pulls data from browser-specs (the list of specs used in Webref), see related pull script. The script only adds WICG entries when they don't exist in WICG's biblio.json file. There are ~50 of them in practice (e.g., DIGITAL-GOODS), which tends to confirm that biblio.json is not up-to-date, or not meant to be comprehensive.

If the file isn't used for other purpose, it would be good to retire the file entirely. That would also simplify maintenance from a Specref perspective (the pull scripts don't handle well the case when a Specref entry that was contributed by browser-specs starts appearing in biblio.json afterwards).

I will make sure that all entries in biblio.json have a corresponding entry in browser-specs, and will prepare a PR against Specref to drop the related WICG pull script.

tidoust avatar Aug 26 '24 12:08 tidoust

Here is a short comparison.

First, the entries that are still missing in browser-specs:

I'll add them to browser-specs.

Then, entries that are missing from browser-specs, but for which the underlying incubation was abandoned or moved somewhere else:

Specref entries should be manuallly updated to note deprecation.

And then, one entry known in browser-specs under a different name:

Specref's entry should be made an alias of the one in browser-specs.

Note: tests in Specref ensure that no entry ever gets removed. No risk of accidently removing an entry from Specref!

tidoust avatar Aug 26 '24 13:08 tidoust

Specref no longer pulls any data from biblio.json. And browser-specs now contributes all active WICG entries to Specref. Anything else holding #198?

tidoust avatar Jan 21 '25 13:01 tidoust

Nope, I think we're good to kill it.

tabatkins avatar Jan 21 '25 17:01 tabatkins

Closing as file has now been deleted.

tidoust avatar Jan 22 '25 13:01 tidoust