-
Notifications
You must be signed in to change notification settings - Fork 29
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
ENH - Document team structure and project roles (#334)
* Create a wip page to document teams * Add details for triage and contributors team * Add details for other sections * π Update team structure * π§ Typo fixes * Apply suggestions from code review Co-authored-by: Tania Allard <[email protected]> * Update docs/docs/community/team-structure.md Co-authored-by: Tania Allard <[email protected]> * π Update Emeritus section --------- Co-authored-by: Tania Allard <[email protected]>
- Loading branch information
1 parent
6dd4f44
commit b76d583
Showing
2 changed files
with
66 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,65 @@ | ||
--- | ||
id: team-structure | ||
title: Project roles and teams | ||
description: Teams, roles, and responsibilities in the Nebari OSS project | ||
--- | ||
|
||
The Nebari project has a team-based governance structure, implemented transparently using [GitHub's team features](https://github.com/orgs/nebari-dev/teams). | ||
This page documents the different teams, their privileges and responsibilities, and how you can join the teams. | ||
|
||
:::tip | ||
Use the table of contents in the right sidebar to jump to different sections of this page. | ||
::: | ||
|
||
## Teams | ||
|
||
The following teams are formally recognized by Nebari. | ||
|
||
### Triage | ||
|
||
Members responsible for [triaging](./maintainers/triage-guidelines) and [improving](./file-issues#working-on-issues-to-improve-them) new and existing issues & pull requests (PRs) across all repositories. They can add relevant labels to issues/PRs, edit issue/PR titles and descriptions to improve them, and transfer issues between repositories. | ||
|
||
### Contributors | ||
|
||
People who make valuable contributions to the Nebari projects in the form of code contributions, documentation improvements, or design enhancements, issues/PR triage, community management, fundraising, advocacy, and more. Members of this team have commit rights across all Nebari repositories, which includes access to [triage](#triage) permissions. | ||
|
||
### Core | ||
|
||
Project sustainers who lead and maintain the overall Nebari project and community. They are the core and final decision-makers on project-wide initiatives, and have repository-level management rights across all Nebari projects. | ||
|
||
### Owners | ||
|
||
A private and small subset of the Core team who have organization-level privileges for [`nebari-dev`](https://github.com/nebari-dev). While decisions are made by the entire Core team, the Owners group has relevant permissions to implement certain decision like adding new team members. | ||
|
||
### Code of Conduct response team | ||
|
||
Community members responsible for upholding and enforcing Nebari's Code of Conduct. This team is documented in the [Nebari governance repository](https://github.com/nebari-dev/governance/blob/main/code-of-conduct/coc_enforcement.md#the-code-of-conduct-committee). At least one member of this team should also be in the Nebari Core team, and all members should be trained to handle CoC reports with care[^1]. | ||
|
||
[^1]: Members can attend any form of online or in-person training on dealing with CoC reports. | ||
|
||
### Emeritus core | ||
|
||
The Emeritus core team recognizes community members who choose to step away from the Core team. Open source projects have members join, retire, and return as the project matures. Contributors can move on for various reasons including limited bandwidth, conflicting or changing interests, burnout, boredom, personal reasons, and much more. | ||
|
||
Nebari Core team members can step away at any time, and we hope for them to communicate this to the rest of the Core team early when possible. They can share as much or as little details as they are comfortable sharing for this move. We also hope they can work with the team for a smooth transition, but we do understand if sometimes this may not be possible. Fellow core team members are expected to support off-boarding members for a graceful transfer of responsibilities. | ||
|
||
Emeritus members are welcome return to the project as active participants, and join the core team again through the process of nomination described earlier. | ||
|
||
## Special interest or working groups | ||
|
||
In addition to the formal teams, new special interest groups (SIG) can be created with commit and triage access to specific Nebari repositories. In the past, examples of special interest groups are "Documentation" and "Design" teams. The core team is responsible for the approval and dissolution of SIGs. | ||
|
||
The Core team can create a new SIG if two or more community members express interest in the [discussion forum](https://github.com/orgs/nebari-dev/discussions/categories/community). | ||
|
||
## Join a team | ||
|
||
Nebari follows a nomination process to add new team members[^2], as detailed in the following table. You can nominate members by opening a GitHub discussions topic in the ["Community" category](https://github.com/orgs/nebari-dev/discussions/categories/community). | ||
|
||
[^2]: All except the [Emeritus core](#emeritus-core) team are decided through nominations. | ||
|
||
| Team | Requirements for nomination | Nominators | Approvers | | ||
| ----------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | ||
| Triage | Engage with (create or comment on) one or more issue/PR/discussion in [`nebari-dev`](https://github.com/nebari-dev) | Any community member (including self) | Any Core team member | | ||
| Contributor | Two or more [contributions](./#how-to-contribute) to Nebari with intention to continue contributing regularly | Any community member (including self) | Any Core team member | | ||
| Core | [Contributors team](#contributors) member with a record of regular, valuable, and high-quality contributions to Nebari for at least one month | Any community member (including self) and one Core team member | Core team makes a [consent-based decision](https://www.sociocracyforall.org/consent-decision-making/) | | ||
| Conduct | Member of the Contributor or Core Team with adequate training to handle CoC reports | Any community member (including self) | Core team makes a [consent-based decision](https://www.sociocracyforall.org/consent-decision-making/) | |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters