|
| 1 | +--- |
| 2 | +id: decision-making |
| 3 | +title: Decision making process |
| 4 | +description: Decision making workflows for the Nebari OSS project |
| 5 | +--- |
| 6 | + |
| 7 | +Nebari's [core team][core-team] is the primary decision making authority for the project. |
| 8 | + |
| 9 | +This group makes decisions about the following non-exhaustive list of items: |
| 10 | + |
| 11 | +- Major updates to the Nebari project and community, through the Request-for-discussion (RFD) process (see explanation below) |
| 12 | +- Adding and removing members from the [Nebari team following the guidelines][nebari-team] |
| 13 | + |
| 14 | +## Consent-based decision making |
| 15 | + |
| 16 | +Nebari follows the [consent-based approach][consent-decision-making] for making all project-related decisions. |
| 17 | + |
| 18 | +In this approach, everyone gets a chance to: |
| 19 | + |
| 20 | +- understand the proposals by asking questions, |
| 21 | +- share their thoughts and reactions, and |
| 22 | +- present any specific objections |
| 23 | + |
| 24 | +Each objection is discussed and the proposal is updated accordingly. The proposal is accepted when the team reaches a point where there are no objections. |
| 25 | + |
| 26 | +## Major updates - Request-for-discussion (RFD) process |
| 27 | + |
| 28 | +New features, sub-projects, and workflow changes that affect a majority of end-users of the core project or the Nebari community, need to follow the Request-for-discussion workflow (sometimes called Enhancement Proposals): |
| 29 | + |
| 30 | +1. Open an [RFD-issue in the governance repository][rfd-issue] with your proposal describing the details, benefits, impact, and more as mentioned in the issue template. Add the following labels to the issue: `needs: discussion 💬`, `type: RFD 🗳` |
| 31 | +2. Tag the `@nebari-dev/core-team` and any specific people for questions, comments, and objections on your proposal. |
| 32 | +3. Answer questions and update the proposal addressing the objections. If there are major objections, the best course of action is declining the RFD, closing the issue, and opening a new RFD issue with the updated design proposal. |
| 33 | +4. Once all comments are addressed, request the core-team to cast votes. Team members are expected to vote "yes" with a 👍 reaction on the proposal if they have no objection. Votes can also be taken over synchronous community meetings. In this case, the decision is documented with a comment on the RFD issue. Remove the `needs: discussion 💬` label and add `status: being voted 🗳` at this stage. |
| 34 | +5. If over 50% of team members vote "yes", the proposal is accepted. Remove the `status: being voted 🗳` label and add `status: approved 💪🏾`. Do not close the issue yet. |
| 35 | +6. Once the proposal is implemented, close the RFD issue. |
| 36 | + |
| 37 | +Learn more in [Gitpod's documentation on decision making][gitpod-rfd]. |
| 38 | + |
| 39 | +## Minor updates - Discussion in issues and pull requests |
| 40 | + |
| 41 | +Minor updates to the codebase and documentation can be discussed in GitHub issues or in pull requests during code review. Contributors are expected to (informally) follow the consent-based decision making philosophy in these discussions. |
| 42 | + |
| 43 | + |
| 44 | +<!-- Reusable links --> |
| 45 | + |
| 46 | +[nebari-team]: /docs/community/team-structure |
| 47 | +[core-team]: https://github.com/orgs/nebari-dev/teams/core-team |
| 48 | +[consent-decision-making]: https://www.sociocracyforall.org/consent-decision-making/ |
| 49 | +[rfd-issue]: https://github.com/nebari-dev/governance/issues/new?assignees=&labels=type%3A+RFD&projects=&template=RFD.md&title=RFD+-+Title |
| 50 | +[gitpod-rfd]: https://gitpod.notion.site/Decision-Making-RFCs-eb4a57f3a34f40f1afbd95e05322af70 |
0 commit comments