Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

meta: add initial GOVERNANCE.md #5040

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

thoughtpolice
Copy link
Collaborator

After thousands of years of deliberation and discussion (where thousands is approximately 0.6yrs), we've finally achieved a draft of the governance document!

This is a draft, as it is fundamentally incomplete; that will require the election of the initial set of 5 Jujutsu Maintainers, after an open self-nomination period! Stay tuned for more on that.


This is the result of a lot of back and forth, the weekly efforts of the governance working group, currently consisting of:

  • Martin von Zweigbergk (martinvonz)
  • Waleed Khan (arxanas)
  • Emily Shaffer (nasamuffin)
  • Austin Seipp (thoughtpolice; yours truly)

Many thanks as well to emeritus member Khionu Sybiern, who helped kickstart this whole process.

This is the result of a lot of back and forth, the weekly efforts of the
governance working group, consisting of:

- Martin von Zweigbergk (martinvonz)
- Waleed Khan (arxanas)
- Emily Shaffer (nasamuffin)
- Austin Seipp (thoughtpolice; yours truly)

Many thanks as well to emeritus member Khionu Sybiern, who helped kickstart this
whole process.

Signed-off-by: Austin Seipp <[email protected]>
@thoughtpolice thoughtpolice self-assigned this Dec 6, 2024

A) Support
B) Rejection
C) Abstinence
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Abstention"?


Jujutsu is an open source project, lead, maintained and designed for a worldwide
community. Anyone who is interested can join, contribute, and participate in the
decision making process. This document is intended to help you understand how
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: hyphenate "decision-making" (maybe just my personal preference, but i noticed that wikipedia does it)

- Martin von Zweigbergk
- TBD

TODO: Pending on the initial process of open nominations, decided by Yuya and
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: drop the "on", i think


- Help users by answering questions
- Participating in lively and respectful discussions across various channels
- Submit high quality bug reports
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: hyphenate "high-quality"

Comment on lines +67 to +68
Note that we consider Contributors to all be valuable, but we *do* define them
as people **who actively participate in the project**. Examples of things that
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems to be saying that we consider non-Contributors valuable. Is that what you meant? Because the "but" doesn't currently seem to indicate any contradiction, so it's a bit confusing. I'm not sure how to say it in a better way. We could just drop the part saying that we consider them valuable.

For the purposes of making decisions across the project, the following processes
are defined.

### Decision Making
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: hyphenate

### Decision Making

The person proposing a decision to be made (i.e. technical, project direction,
etc) can offer a proposal, along with a discussion timeline from 2-to-4 weeks.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: "from" and the hyphenated "2-to-4" seem inconsistent. Drop the hyphens? Or maybe "along with a 2-to-4-week timeline"

Comment on lines +99 to +100
A final decision can be reached upon consensus being achieved, which is defined
as more than half of the participating votes (i.e. excluding abstaining votes.)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Slightly simpler: "A final decision requires more than half of the participating votes (i.e. excluding abstaining votes.)". I mostly wanted to avoid "consensus" and the risk of the reader trying to guess if that means >=50%. We do say that we mean >50%, but the word "consensus" doesn't seem to add anything. I think the line below can also be dropped because it's just the inverse implication from this sentence (i.e. a => b implies !b => !a).

proposal can move on and be accepted immediately. In the event no consensus is
reached, a proposal may be re-submitted later on.

This document itself is subject to the Decision Making process by the existing
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: hyphenate "Decision-Making" here too

Comment on lines +115 to +116
active participants. A vote and discussion by the existing Maintainers will be
used to decide the outcome.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this require >50% or >=2/3 of the Maintainers' votes?

@PhilipMetzger
Copy link
Collaborator

You forgot to add it to the website and renaming the old temporary governance.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants