browser-specs 3.22.1 → 3.24.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 +787 -43
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -39,6 +39,7 @@ cross-references, WebIDL, quality, etc.
39
39
  - [`release.pages`](#releasepages)
40
40
  - [`nightly`](#nightly)
41
41
  - [`nightly.url`](#nightlyurl)
42
+ - [`nightly.alternateUrls`](#nightlyalternateurls)
42
43
  - [`nightly.filename`](#nightlyfilename)
43
44
  - [`nightly.pages`](#nightlypages)
44
45
  - [`nightly.repository`](#nightlyrepository)
@@ -401,6 +402,28 @@ details the actual provenance.
401
402
  The `url` property is always set.
402
403
 
403
404
 
405
+ #### `nightly.alternateUrls`
406
+
407
+ A list of alternate URLs for the Editor's Draft or the living standard.
408
+
409
+ The list typically contains URLs that external sources may use to reference the
410
+ spec, be it because the canonical URL evolved over time and sources still use
411
+ old URLs (e.g. when the spec was incubated in a Community Group and transitioned
412
+ to a Working Group), or because the canonical URL is unstable for some reason
413
+ and external sources decided to use a workaround (e.g. CSS drafts).
414
+
415
+ Alternate URLs should only be used to ease mapping between external sources and
416
+ specs in `browser-specs`. The canonical URL in [`nightly.url`](#nightlyurl)
417
+ should be preferred to reference a spec otherwise.
418
+
419
+ Alternate URLs are only set when needed, meaning when an alternate URL is
420
+ effectively in use in some external source and when the external source cannot
421
+ easily be updated to use the canonical URL. In particular, the list is not meant
422
+ to be exhaustive.
423
+
424
+ The `alternateUrls` property is always set and is often an empty array.
425
+
426
+
404
427
  #### `nightly.filename`
405
428
 
406
429
  The filename of the resource that gets served when the default URL is fetched.