Skip to content

Commit 67b5644

Browse files
authored
Merge pull request #9270 from Prajyot-Parab/mymain
📖 Documentation improvements: suggestions for team leads
2 parents 32169f3 + 007b980 commit 67b5644

File tree

2 files changed

+35
-14
lines changed

2 files changed

+35
-14
lines changed

docs/release/release-tasks.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ This document details the responsibilities and tasks for each role in the releas
2626
- [[Continuously] Maintain the GitHub release milestone](#continuously-maintain-the-github-release-milestone)
2727
- [[Continuously] Bump the Go version](#continuously-bump-the-go-version)
2828
- [[Repeatedly] Cut a release](#repeatedly-cut-a-release)
29+
- [[Optional] Public release session](#optional-public-release-session)
2930
- [[Optional] [Track] Bump the Cluster API apiVersion](#optional-track-bump-the-cluster-api-apiversion)
3031
- [[Optional] [Track] Bump the Kubernetes version](#optional-track-bump-the-kubernetes-version)
3132
- [Communications/Docs/Release Notes Manager](#communicationsdocsrelease-notes-manager)
@@ -238,7 +239,7 @@ Additional information:
238239
* Create a release tag on the GitHub repository.
239240
* Create/update/publish GitHub releases.
240241
241-
[Optional] Public release session
242+
#### [Optional] Public release session
242243
1. Host a release session over a public zoom meeting.
243244
2. Record the session for future reference and transparency.
244245
3. Use release process-related waiting periods as a forum for discussing issues/questions.

docs/release/release-team.md

Lines changed: 33 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33

4-
* [Cluster API Release Team](#cluster-api-release-team)
5-
* [Overview](#overview)
6-
* [Goals](#goals)
7-
* [Non-Goals/Future work](#non-goalsfuture-work)
8-
* [Duration of Term](#duration-of-term)
9-
* [Specific Responsibilities](#specific-responsibilities)
10-
* [Team Roles](#team-roles)
11-
* [Team Selection](#team-selection)
12-
* [Selection Criteria](#selection-criteria)
13-
* [Time Commitment](#time-commitment)
14-
* [Why should I volunteer?](#why-should-i-volunteer)
15-
* [Cluster API release team vs kubernetes/kubernetes-SIG membership](#cluster-api-release-team-vs-kuberneteskubernetes-sig-membership)
4+
- [Cluster API Release Team](#cluster-api-release-team)
5+
- [Overview](#overview)
6+
- [Goals](#goals)
7+
- [Non-Goals/Future work](#non-goalsfuture-work)
8+
- [Duration of Term](#duration-of-term)
9+
- [Specific Responsibilities](#specific-responsibilities)
10+
- [Team Roles](#team-roles)
11+
- [Team Selection](#team-selection)
12+
- [Selection Criteria](#selection-criteria)
13+
- [Time Commitment](#time-commitment)
14+
- [Suggestions for Team Leads](#suggestions-for-team-leads)
15+
- [Why should I volunteer?](#why-should-i-volunteer)
16+
- [Cluster API release team vs kubernetes/kubernetes-SIG membership](#cluster-api-release-team-vs-kuberneteskubernetes-sig-membership)
1617

1718
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
1819

@@ -89,10 +90,29 @@ When assembling a release team, the release team lead should look for volunteers
8990

9091
## Time Commitment
9192

92-
As a member of the release team, you should expect to spend approximately 4-8 hours a week on release related activities for the duration of the term.
93+
As a member of the release team, you should expect to spend approximately 4-8 hours a week on release related activities for the duration of the term.
94+
95+
Specific time commitments include:
96+
* Release Team meetings once a week throughout the entire release cycle.
97+
* Release Day meetings ideally occurring once during the actual release weeks. Refer to release cycle timeline for more specific details.
98+
* Any other release-related critical meetings with prior notice.
99+
100+
While we don't anticipate individuals to be available every week during the release cycle, please feel free to inform the team of any unavailability so we can plan accordingly.
93101

94102
Before you volunteer to be part of a CAPI release team, please make certain that your employer is aware and supportive of your commitment to the release team.
95103

104+
## Suggestions for Team Leads
105+
106+
* Clearly communicate with the team shadows you are responsible for, that the majority of the work during the release cycle will be a collaborative effort.
107+
* Establish an ownership rotation policy in consultation with respective team members.
108+
* Provide opportunities for team members to take the lead in cutting a release within the cycle, based on feasibility.
109+
* Define backup ownership and tasks for team members, such as:
110+
* Hosting release team meetings.
111+
* Communicating key updates during office hours meetings when necessary.
112+
* Sharing release-related updates with the CAPI community.
113+
* Monitoring and reporting CI status regularly to the release team.
114+
* Scheduling additional meetings as required to facilitate a smooth release cycle.
115+
96116
## Why should I volunteer?
97117

98118
Volunteering to be part of a CAPI release team is a great way to contribute to the community and to the release process:

0 commit comments

Comments
 (0)