@@ -145,3 +145,27 @@ 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+ - Commit and merge the change, no other alterations or automation is
165+ necessary in the CLI repo.
166+ 2. Update
167+ [`angular.dev` documentation](https://github.com/angular/angular/tree/main/adev/src/content/reference/versions.md#browser-support)
168+ to specify the date used and link to [browsersl.ist](https://browsersl.ist)
169+ with the generated configuration.
170+ - `bazel build //packages/angular/build:angular_browserslist && cat dist/bin/packages/angular/build/.browserslistrc`
171+ to view and copy the generated `browserslist` configuration.
0 commit comments