Skip to content

Commit 49c00ac

Browse files
authored
Add a validation guarantee to curated CDDL extracts (#1422)
* Add a validation guarantee to curated CDDL extracts This leverages CDDL validation in Strudy to provide a validation guarantee to curated CDDL extracts. A `cddlpatches` folder, which will hopefully remain empty, gets added so that we may temporarily patch CDDL extracts that become invalid. * Adjust list of ignorable Web IDL anomalies Bumping the version of Strudy brings new Web IDL anomaly types: - `noEvent` needs events data that is not included in the data we pass to the study function. It must be ignored. - `urlType` is new and we probably don't want to block curation because of it, at least for now (or we're going to have a lot of patching to do...)
1 parent 90c3f4f commit 49c00ac

9 files changed

+196
-420
lines changed

README.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,9 @@ Data curation brings the following guarantees.
9292

9393
### CDDL extracts
9494

95-
The CDDL extracts currently come with no guarantee whatsoever and may be invalid. Tracked in [#1417](https://github.com/w3c/webref/issues/1417).
95+
- All CDDL files pass CDDL analysis by the version of [Strudy](https://github.com/w3c/strudy) referenced in `package.json`. Said differently, all CDDL files can be parsed by the version of [cddlparser](https://github.com/tidoust/cddlparser) referenced by Strudy.
96+
97+
The CDDL extracts are not released in an NPM package for the time being.
9698

9799
## Known consumers
98100

ed/cddlpatches/README.md

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# CDDL patches
2+
3+
These are patches applied to the CDDL extracts scraped from specs. These patches can break as specs are updated and thus need ongoing maintenance.
4+
5+
For details on how to create and update patches, please see the [Web IDL patches documentation](../idlpatches/README.md)

0 commit comments

Comments
 (0)