Skip to content

Commit 618fe19

Browse files
committed
docs: update release docs to describe how to upgrade the browser policy
1 parent 4047497 commit 618fe19

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

Diff for: docs/process/release.md

+31
Original file line numberDiff line numberDiff line change
@@ -145,3 +145,34 @@ will block the next weekly release.
145145
accept the invite for the new package.
146146
147147
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

Comments
 (0)