Skip to content

Latest commit

 

History

History
79 lines (55 loc) · 3.47 KB

release.md

File metadata and controls

79 lines (55 loc) · 3.47 KB

Setting Up Local Repository

  1. Clone the Angular-CLI repo. A local copy works just fine.
  2. Create an upstream remote:
$ git remote add upstream https://github.com/angular/angular-cli.git

Caretaker

The caretaker should triage issues, merge PR, and sheppard the release.

Caretaker calendar can be found here.

Each shift consists of two caretakers. The primary caretaker is responsible for merging PRs to master and patch whereas the secondary caretaker is responsible for the release. Primary-secondary pairs are as follows:

Primary Secondary
Alan Doug
Charles Keen
Filipe Joey

Merging PRs

The list of PRs which are currently ready to merge (approved with passing status checks) can be found with this search. This list should be checked daily and any ready PRs should be merged. For each PR, check the target label to understand where it should be merged to. You can find which branches a specific PR will be merged into with the yarn ng-dev pr check-target-branches <pr> command.

When ready to merge a PR, run the following command:

yarn ng-dev pr merge <pr>

Maintaining LTS branches

Releases that are under Long Term Support (LTS) are listed on angular.io.

Since there could be more than one LTS branch at any one time, PR authors who want to merge commits into LTS branches must open a pull request against the specific base branch they'd like to target.

In general, cherry picks for LTS should only be done if it meets one of the criteria below:

  1. It addresses a critical security vulnerability.
  2. It fixes a breaking change in the external environment. For example, this could happen if one of the dependencies is deleted from NPM.
  3. It fixes a legitimate failure on CI for a particular LTS branch.

Release

Releasing is performed using Angular's unified release tooling. Each week, two releases are expected, latest and next on npm.

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. 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. The current packages that require adjustment are:

  • @angular-devkit/build-angular: packages/angular_devkit/build_angular/package.json
  • @ngtools/webpack: packages/ngtools/webpack/package.json

To perform a release run the following and navigate the prompts:

yarn ng-dev release publish

Changing shifts

If you need to update the caretaker calendar to modify shifts, make sure you are logged in as your @angular.io account and click the "+ Google Calendar" button in the bottom right to add it to your Google Calendar account. You should then be able to find and modify events on calendar.google.com. The calendar is a part of the angular.io organization, so events can only be modified by users in the same organization.