Skip to content

Commit e569d3b

Browse files
committed
docs: update release documentation to reflect changes to caretaker responsibilities and new rotation
1 parent fb6ba67 commit e569d3b

File tree

1 file changed

+31
-18
lines changed

1 file changed

+31
-18
lines changed

docs/process/release.md

Lines changed: 31 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,27 @@ $ git remote add upstream https://github.com/angular/angular-cli.git
1111

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

14-
Caretaker calendar can be found [here](https://calendar.google.com/calendar/embed?src=angular.io_jf53juok1lhpm84hv6bo6fmgbc%40group.calendar.google.com&ctz=America%2FLos_Angeles).
15-
16-
Each shift consists of two caretakers. The primary caretaker is responsible for
17-
merging PRs to `main` and patch whereas the secondary caretaker is responsible
18-
for the release.
19-
20-
At the end of each caretaker's rotation, they should peform a handoff in which they provide
21-
information to the next caretaker about the current state of the repository and update the
22-
access group to now include the next caretaker and their secondary. To perform this update
23-
to the access group, the caretaker can run:
14+
Caretaker rotation can be found
15+
[here](https://rotations.corp.google.com/rotation/5117919353110528) and individual shifts can
16+
be modified as necessary to accomodate caretaker's schedules. This automatically syncs to a
17+
Google Calendar
18+
[here](https://calendar.google.com/calendar/u/0/[email protected]).
19+
Click the "+" button in the bottom right to add it to your calendar to see shifts alongside the
20+
rest of your schedule.
21+
22+
The primary caretaker is responsible for both merging PRs and performing the weekly release.
23+
The secondary caretaker does not have any _direct_ responsibilities, but they may need to take
24+
over the primary's responsibilities if the primary is unavailable for an extended time (a day
25+
or more) or in the event of an emergency.
26+
27+
The primary is also responsible for releasing
28+
[Angular Universal](https://github.com/angular/universal/), but _not_ responsible for merging
29+
PRs.
30+
31+
At the end of each caretaker's rotation, the primary should peform a handoff in which they
32+
provide information to the next caretaker about the current state of the repository and update
33+
the access group to now include the next caretakers. To perform this update to the access group,
34+
the caretaker can run:
2435

2536
```bash
2637
$ yarn ng-dev caretaker handoff
@@ -95,12 +106,14 @@ navigate the prompts:
95106
yarn ng-dev release publish
96107
```
97108

98-
## Changing shifts
109+
Releases should be done in "reverse semver order", meaning they should follow:
110+
111+
Oldest LTS -> Newest LTS -> Patch -> RC -> Next
112+
113+
This can skip any versions which don't need releases, so most weeks are just "Patch -> Next".
114+
115+
### Angular Universal
99116

100-
If you need to update the
101-
[caretaker calendar](https://calendar.google.com/calendar/embed?src=angular.io_jf53juok1lhpm84hv6bo6fmgbc%40group.calendar.google.com&ctz=America%2FLos_Angeles)
102-
to modify shifts, **make sure you are logged in as your @angular.io account** and
103-
click the "+ Google Calendar" button in the bottom right to add it to your Google
104-
Calendar account. You should then be able to find and modify events on
105-
calendar.google.com. The calendar is a part of the `angular.io` organization, so
106-
events can only be modified by users in the same organization.
117+
After CLI releases, the primary is also responsible for releasing Angular Universal if necessary.
118+
Follow [the instructions there](https://github.com/angular/universal/blob/main/docs/process/release.md)
119+
for the release process. If there are no changes to Universal, then the release can be skipped.

0 commit comments

Comments
 (0)