Skip to content

Commit e8b8e9c

Browse files
committed
docs: update release docs to describe how to upgrade the browser policy
1 parent 23692e5 commit e8b8e9c

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

Diff for: docs/process/release.md

+21
Original file line numberDiff line numberDiff line change
@@ -145,3 +145,24 @@ 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) "widely available"
152+
date. Before a new major version is released, this should be updated to approximately the current
153+
date.
154+
155+
A few weeks before a major (around feature freeze):
156+
157+
1. Update `baselineThreshold` in
158+
[`browserslist/package.json`](/packages/angular/build/src/browserslist/package.json) to the
159+
end of the most recent month.
160+
- For example, if it is currently May 12th, set `baselineThreshold` to April 30th.
161+
- Picking a date at the end of a month makes it easier to cross-reference Angular's support
162+
with other tools (like MDN) which state Baseline support using month specificity.
163+
- Commit and merge the change, no other alterations or automation is necessary in the CLI
164+
repo.
165+
2. Update
166+
[`angular.dev` documentation](https://github.com/angular/angular/tree/main/adev/src/content/reference/versions.md#browser-support)
167+
to specify the date used and link to [browsersl.ist](https://browsersl.ist) with the
168+
generated configuration.

0 commit comments

Comments
 (0)