Skip to content

Commit bae9df6

Browse files
committed
Correct leads teams process
Previously these docs said that the leads only needed to be added to the '... leads_' team and permissions would be inherited for regular contributions. This is true for the repositories, however the leads also need to be able to manage the team members list, which requires them to have 'maintainer' role on the team (and also to be in that team).
1 parent 857e822 commit bae9df6

File tree

1 file changed

+27
-9
lines changed

1 file changed

+27
-9
lines changed

docs/ways-of-working/GitHub/manage_github_teams.md

Lines changed: 27 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -28,22 +28,40 @@ Typically a new joiner will need to be added to at least two teams:
2828

2929
### Adding a regular contributor
3030

31-
1. In the [Teams list](https://github.com/orgs/LBHackney-IT/teams) click on the team you want to add them to.
31+
Any lead can add people to one or more of their teams.
32+
33+
1. In the [Teams list](https://github.com/orgs/LBHackney-IT/teams) click on the team you want to add them to, e.g. `Housing Products`.
3234
2. Click `Add a member`
3335
3. Search for the user's GitHub username.
3436
4. Click `Invite`.
3537

3638
### Adding a lead
3739

38-
Leads are added in a subtly different way, in order to grant them the `Admin` role to repositories the team is responsible for.
40+
Leads are added in a subtly different way, in order to grant them the `Admin` role to repositories the team is responsible for. We add the lead to both the main product _and_ the leads teams, and set them as team maintainers so they can add and remove team members.
3941

4042
> ℹ️ A "lead" in this context is someone trusted to manage the project, and doesn't reflect a specific job title.
4143
42-
1. In the [Teams list](https://github.com/orgs/LBHackney-IT/teams) find the team you want to add them to.
43-
2. Click the disclosure arrow on the right hand side (next to `X teams`, and click the relevant "... leads" team).
44-
![Screenshot showing the above steps to select the leads team.](../img/github_add_to_leads_team.png)
45-
3. Click `Add a member`
46-
4. Search for the user's GitHub username.
47-
5. Click `Invite`.
44+
Any lead can add another lead, or this can be carried out by a GitHub admin, e.g. the Head of Engineering.
4845

49-
> ℹ️ The lead doesn't need to be added to the parent team, because the permissions are inherited.
46+
1. In the [Teams list](https://github.com/orgs/LBHackney-IT/teams) find the team you want to add them to, e.g. `Housing Products`.
47+
2. Click the disclosure arrow on the right hand side (next to `X teams`, and click the relevant "... leads" team).
48+
![Screenshot showing the above steps to select the leads team.](../img/github_add_to_leads_team.png), and add the user:
49+
1. Click `Add a member`.
50+
2. Search for the user's GitHub username.
51+
3. Click `Invite`.
52+
3. Change their role to 'Maintainer' for the team:
53+
1. Click the check box to the left of the user.
54+
2. Click the `1 member selected` drop-down.
55+
3. Click `Change role`.
56+
4. Select `Maintainer`.
57+
5. Click `Change role`.
58+
4. Go to the parent team (e.g. `Housing Products`), and add the user:
59+
1. Click `Add a member`
60+
2. Search for the user's GitHub username.
61+
3. Click `Invite`.
62+
5. Change their role to 'Maintainer' for the team:
63+
1. Click the check box to the left of the user.
64+
2. Click the `1 member selected` drop-down.
65+
3. Click `Change role`.
66+
4. Select `Maintainer`.
67+
5. Click `Change role`.

0 commit comments

Comments
 (0)