web-specs 2.24.1 → 2.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +23 -0
  2. package/index.json +798 -43
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -38,6 +38,7 @@ cross-references, WebIDL, quality, etc.
38
38
  - [`release.pages`](#releasepages)
39
39
  - [`nightly`](#nightly)
40
40
  - [`nightly.url`](#nightlyurl)
41
+ - [`nightly.alternateUrls`](#nightlyalternateurls)
41
42
  - [`nightly.filename`](#nightlyfilename)
42
43
  - [`nightly.pages`](#nightlypages)
43
44
  - [`nightly.repository`](#nightlyrepository)
@@ -399,6 +400,28 @@ details the actual provenance.
399
400
  The `url` property is always set.
400
401
 
401
402
 
403
+ #### `nightly.alternateUrls`
404
+
405
+ A list of alternate URLs for the Editor's Draft or the living standard.
406
+
407
+ The list typically contains URLs that external sources may use to reference the
408
+ spec, be it because the canonical URL evolved over time and sources still use
409
+ old URLs (e.g. when the spec was incubated in a Community Group and transitioned
410
+ to a Working Group), or because the canonical URL is unstable for some reason
411
+ and external sources decided to use a workaround (e.g. CSS drafts).
412
+
413
+ Alternate URLs should only be used to ease mapping between external sources and
414
+ specs in `browser-specs`. The canonical URL in [`nightly.url`](#nightlyurl)
415
+ should be preferred to reference a spec otherwise.
416
+
417
+ Alternate URLs are only set when needed, meaning when an alternate URL is
418
+ effectively in use in some external source and when the external source cannot
419
+ easily be updated to use the canonical URL. In particular, the list is not meant
420
+ to be exhaustive.
421
+
422
+ The `alternateUrls` property is always set and is often an empty array.
423
+
424
+
402
425
  #### `nightly.filename`
403
426
 
404
427
  The filename of the resource that gets served when the default URL is fetched.