Skip to content

Commit b5deab1

Browse files
committed
docs: update major release instructions to mention latest-versions.ts bump
1 parent 9175811 commit b5deab1

File tree

1 file changed

+17
-3
lines changed

1 file changed

+17
-3
lines changed

docs/process/release.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -87,9 +87,23 @@ or a separate PR after FW releases but before CLI releases.
8787

8888
**For a major release:**
8989

90-
When a release is transitioning from a prerelease to a stable release, the semver ranges for Angular dependencies within the packages' `package.json` files will need to be updated to remove the prerelease version segment.
91-
For example, `"@angular/compiler-cli": "^13.0.0 || ^13.0.0-next"` in a prerelease should become `"@angular/compiler-cli": "^13.0.0"` in the stable release.
92-
The current packages that require adjustment are:
90+
**As part of the release PR**, make sure to:
91+
92+
- modify
93+
[`latest-versions.ts`](https://github.com/angular/angular-cli/blob/main/packages/schematics/angular/utility/latest-versions.ts#L18)
94+
so the Angular semver is updated from `~13.0.0-rc` to just `~13.0.0`.
95+
- This is the version generated in `ng new` schematics and needs to be updated to avoid having
96+
users generate projects with `-rc` in the dependencies.
97+
- update the
98+
[`ng-packagr`](https://github.com/angular/angular-cli/blob/main/packages/schematics/angular/utility/latest-versions/package.json#L15)
99+
dependency to a stable version (ex. from `^13.0.0-next.0` to `^13.0.0`).
100+
101+
When a release is transitioning from a prerelease to a stable release, the semver ranges for Angular
102+
dependencies within the packages' `package.json` files will need to be updated to remove the
103+
prerelease version segment. For example, `"@angular/compiler-cli": "^13.0.0 || ^13.0.0-next"` in a
104+
prerelease should become `"@angular/compiler-cli": "^13.0.0"` in the stable release. This can happen
105+
as a follow-up item _after_ the release PR and the stable release, actually shipped in the `13.0.1`
106+
release. The current packages that require adjustment are:
93107

94108
- `@angular-devkit/build-angular`: [packages/angular_devkit/build_angular/package.json](/packages/angular_devkit/build_angular/package.json)
95109
- `@ngtools/webpack`: [packages/ngtools/webpack/package.json](/packages/ngtools/webpack/package.json)

0 commit comments

Comments
 (0)