Skip to content

Commit 6c8b37d

Browse files
committed
docs: update release docs to describe how to upgrade the browser policy
1 parent f70963f commit 6c8b37d

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

docs/process/release.md

+24
Original file line numberDiff line numberDiff line change
@@ -145,3 +145,27 @@ 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+
- 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

Comments
 (0)