@@ -145,3 +145,34 @@ will block the next weekly release.
145
145
accept the invite for the new package.
146
146
147
147
Once 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