Skip to content

Commit 7c0ef67

Browse files
pavithraeskcpevey
andauthored
Add decision making process (#487)
Signed-off-by: Pavithra Eswaramoorthy <[email protected]> Co-authored-by: Kim Pevey <[email protected]>
1 parent 2207fb0 commit 7c0ef67

File tree

2 files changed

+52
-1
lines changed

2 files changed

+52
-1
lines changed
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
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

docs/sidebars.js

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,6 @@ module.exports = {
118118
"community/nebari-tests",
119119
"community/doc-contributions",
120120
"community/style-guide",
121-
"community/team-structure",
122121
"community/plugins",
123122
{
124123
type: "category",
@@ -131,6 +130,8 @@ module.exports = {
131130
"community/maintainers/release-process-branching-strategy",
132131
],
133132
},
133+
"community/team-structure",
134+
"community/decision-making",
134135
],
135136
},
136137
{

0 commit comments

Comments
 (0)