diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53200e0b41..e9adb95a8a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -137,6 +137,16 @@
 
 ### BREAKING CHANGES
 
+* npm packages: code in ESM format is now published at the default location in the npm package with `package.json`'s `main` entry pointing to an UMD bundle (primarily for node, and webpack 1 users).
+
+  If you are using SystemJS to load Angular, you should adjust your SystemJS configuration to point to the UMD bundles (present in the npm package).
+
+  Please see this [example SystemJS config](https://github.com/angular/quickstart/blob/3b7452cc444c49c139ea39523ced0468c2362c16/systemjs.config.js#L17-L34).
+
+* testing config: due to zone.js peer-dependency upgrade, the order in which various zone specs are loaded has changed.
+
+  Please see [this example Karma config](https://github.com/angular/quickstart/blob/3b7452cc444c49c139ea39523ced0468c2362c16/karma.conf.js#L31-L38).
+
 * core: `Type` is now `Type<T>` which means that in most cases you have to
 use `Type<any>` in place of `Type`.