Structuring GitHub teams
Teams are not just the more convenient way to grant permissions to repositories that allow faster on- and off-boarding. They can also be used to share knowledge and notify certain groups of changes.
Teams have discussions, and you can see their repositories and projects. Teams can have one of the following two visibilities:
- Visible: A visible team can be seen and mentioned by every member of this organization
- Secret: A secret team can only be seen by its members and may not be nested
A team exists in the namespace of an organization. This means that the name of the team must be unique inside the organization. You can mention a team or add it as a code owner using the following syntax:
@<organization>/<team-name>
You can use teams to reflect your company or group’s structure with cascading access permissions and mentions by nesting them. You can do this by specifying a parent team when creating a new team. This...