@@ -145,3 +145,34 @@ will block the next weekly release.
145145 accept the invite for the new package.
146146
147147Once Wombat accepts the invite, regular automated releases should work as expected.
148+
149+ ## Updating Browser Support
150+
151+ Angular' s browser support is defined by a [Baseline](https://web.dev/baseline)
152+ " widely available" date. Before a new major version is released, this should be
153+ updated to approximately the current date.
154+
155+ A few weeks before a major (around feature freeze):
156+
157+ 1. Update ` BASELINE_DATE` in
158+ [` /constants.bzl` ](/constants.bzl) to the end of the most recent month.
159+ - For example, if it is currently May 12th, set ` baselineThreshold` to April
160+ 30th.
161+ - Picking a date at the end of a month makes it easier to cross-reference
162+ Angular' s support with other tools (like MDN) which state Baseline support
163+ using month specificity.
164+ - You can view the generated `browserlist` configuration with:
165+ ```shell
166+ bazel build //packages/angular/build:angular_browserslist
167+ cat dist/bin/packages/angular/build/.browserslistrc
168+ ```
169+ - Commit and merge the change, no other alterations or automation is
170+ necessary in the CLI repo.
171+ 2. Update
172+ [`/.browserslistrc`](https://github.com/ng-packagr/ng-packagr/tree/main/.browserslistrc)
173+ in the `ng-packagr` repo.
174+ - Use the generated configuration from above.
175+ 3. Update
176+ [`angular.dev` documentation](https://github.com/angular/angular/tree/main/adev/src/content/reference/versions.md#browser-support)
177+ to specify the date used and link to [browsersl.ist](https://browsersl.ist)
178+ with the generated configuration.
0 commit comments