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

Update org owners, define authority and responsibilities #37

Merged
merged 1 commit into from
Nov 29, 2024

Conversation

infinisil
Copy link
Member

After discussions with the Steering Committee to set the general direction for this, here's a hashed-out proposal by me to update org owners and define their authority and responsibilities.

Needs to be approved by @NixOS/steering before it can be merged. Note that the convention for this repo is that the person merging also implements the changes.

Also note that the first commit is shared with #36.

Copy link
Member

@zimbatm zimbatm left a comment

Choose a reason for hiding this comment

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

A few ideas, but looks good overall

.github/CODEOWNERS Outdated Show resolved Hide resolved
doc/github-org-owners.md Outdated Show resolved Hide resolved

For any GitHub-related needs, you can reach out to the org owners by either:
- [Creating an issue in this repository](https://github.com/NixOS/org/issues/new).
- Messaging in the [Github org owners help desk Matrix room](https://matrix.to/#/#org_owners:nixos.org).
Copy link
Member

Choose a reason for hiding this comment

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

Maybe something for later:

I'd like us to standardize using GitHub issues to discuss GitHub-related topics. Spreading information in two places is not optimal for transparency reasons.

doc/github-org-owners.md Outdated Show resolved Hide resolved
doc/github-org-owners.md Outdated Show resolved Hide resolved
doc/github-org-owners.md Show resolved Hide resolved
@infinisil infinisil requested a review from a team as a code owner November 28, 2024 16:59
@infinisil
Copy link
Member Author

infinisil commented Nov 28, 2024

Applied @zimbatm's suggestions and included some follow-up changes.

Here's a more easily viewable diff since y'all approved the last time: https://github.com/NixOS/org/compare/6f99f49dc3a019a67eccf7f1d804ef4b50686edd..40b246011b6c71dfa8fb16eeb72ac68dc22b0986 (this diff also includes #36 due to the rebase force push though)

Copy link
Member

@zimbatm zimbatm left a comment

Choose a reason for hiding this comment

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

thanks @infinisil

@Lassulus
Copy link
Member

so we have 4 SC approvals (a majority) and the proposal was created 4 days ago. If I interpret the SCs voting rules correctly that means I can implement those changes and merge this PR?

@Gabriella439
Copy link

@Lassulus: I'm going to say: yes.

I generally want us to err on the side of doing things. If we make a mistake in interpreting the rules we can always revert it.

- Moderation decisions by the moderation team.
- Changes from approved RFCs.
- Low-impact changes, such as:
- Adding new org members to allow review requests.
Copy link
Member

Choose a reason for hiding this comment

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

How do you imagine this to be used? In Nixpkgs, this is handled by commiter delegation team, and in other repos like Nix, I would expect them to have owners who would ideally self-organize.

Copy link
Member Author

Choose a reason for hiding this comment

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

This is just for the issue of people missing the automated org invite they get after adding themselves to lib.maintainers, see NixOS/nixpkgs#234293. An org owner currently needs to resend these missed invites, since there's no automation for that. These invites give no commit access, they're just to allow requesting reviews from maintainers.

- Creating new unprivileged Nixpkgs teams for mention.
- Updating repository meta information.

With approval by at least 2 org owners, they can take care of implementing
Copy link
Member

Choose a reason for hiding this comment

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

Maybe make it clearer if the 2 includes the implementer.

Suggested change
With approval by at least 2 org owners, they can take care of implementing
With approval by at least 2 other org owners, they can take care of implementing

or

Suggested change
With approval by at least 2 org owners, they can take care of implementing
With approval by at least one other org owner, they can take care of implementing

Copy link
Member Author

Choose a reason for hiding this comment

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

The latter, I think this should be even more clear:

Suggested change
With approval by at least 2 org owners, they can take care of implementing
Org owners need approval from at least one other org owner to take care of implementing

@Lassulus Lassulus merged commit 7169ff4 into main Nov 29, 2024
2 checks passed
@Lassulus Lassulus deleted the org-owners branch November 29, 2024 21:18
@Lassulus
Copy link
Member

Alright, I created a team and made everyone individually an org owner.

@Lassulus
Copy link
Member

@NixOS/org-owners is the team btw :)

@infinisil
Copy link
Member Author

@Lassulus No need for a new team, the docs you just merged document @NixOS/org!

@Lassulus
Copy link
Member

ah well, feel free to remove that team :D

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.

8 participants