browser-specs - npm Package Compare versions

Comparing version 3.75.0 to 4.0.0

package.json

 {
   "name": "browser-specs",
-  "version": "3.75.0",
+  "version": "4.0.0",
   "description": "Curated list of technical Web specifications that are directly implemented or that will be implemented by Web browsers.",
@@ -5,0 +5,0 @@ "repository": {

README.md

@@ -14,2 +14,3 @@ # Web browser specifications
 - [Installation and usage](#installation-and-usage)
+- [Upgrading](#upgrading)
 <!-- COMMON-TOC: start -->
@@ -84,2 +85,11 @@ - [Spec object](#spec-object)
 
+## Upgrading
+
+The only breaking change in version `4.x` is that some spec entries may not
+have a `nightly` property. This happens for specs that are not public. An
+example of a non public spec is an ISO standard. In such cases, the `url`
+property targets the public page that describes the spec on the standardization
+organization's web site. To upgrade from version `3.x` to version `4.x`, make
+sure that your code can handle specs without a `nightly` property.
+
 <!-- COMMON-BODY: start -->
@@ -140,3 +150,6 @@ ## Spec object
 TR documents, this is the TR URL. For WHATWG specs, this is the URL of the
-living standard. In other cases, this is the URL of the latest Editor's Draft.
+living standard. For specs developed by an organization that does not provide
+a public version of the spec such as ISO, this is the URL of the page that
+describes the spec on the organization's web site. In other cases, this is the
+URL of the latest Editor's Draft.
 
@@ -335,3 +348,4 @@ The URL should be relatively stable but may still change over time. See
 
-The `nightlyUrl` property is always set.
+The `nightlyUrl` property is always set when the [`nightly`](#nightly) property
+is set.
 
@@ -463,3 +477,5 @@
 
-The `nightly` property is always set.
+The `nightly` property is always set unless the spec does not have a public
+version available through a URL. For instance, ISO specs are not publicly
+available.
 
@@ -466,0 +482,0 @@

No alert changes

Improved metrics

Total package byte prevSize

746428

increased by0.4%

Lines of code

23419

increased by0.3%

Number of lines in readme file

757

increased by2.16%

No dependency changes