Skip to content

Commit

Permalink
Merge pull request #37 from NixOS/org-owners
Browse files Browse the repository at this point in the history
Update org owners, define authority and responsibilities
  • Loading branch information
Lassulus authored Nov 29, 2024
2 parents f5ae963 + ebe9741 commit 7169ff4
Show file tree
Hide file tree
Showing 4 changed files with 54 additions and 12 deletions.
3 changes: 2 additions & 1 deletion .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@

/doc/org-repo.md @NixOS/steering
/doc/discourse.md @NixOS/steering
/doc/github.md @NixOS/steering
/doc/github.md @NixOS/org
/doc/github-org-owners.md @NixOS/steering
/doc/matrix.md @NixOS/steering
/doc/moderation.md @NixOS/steering
/doc/nixos-releases.md @NixOS/steering
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ For contributing see [here](./CONTRIBUTING.md).
- [Org repo](./doc/org-repo.md)
- [Discourse](./doc/discourse.md)
- [GitHub](./doc/github.md)
- [Org owners](./doc/github-org-owners.md)
- [Matrix](./doc/matrix.md)
- [Moderation](./doc/moderation.md)
- [NixOS releases](./doc/nixos-releases.md)
Expand Down
50 changes: 50 additions & 0 deletions doc/github-org-owners.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
## GitHub org owners

The following people have the GitHub "owners" permissions on the NixOS organization:
<!-- Also keep this in sync with the members of @NixOS/org! -->
- [@infinisil](https://github.com/infinisil)
- [@lassulus](https://github.com/lassulus)
- [@tomberek](https://github.com/tomberek)
- [@winterqt](https://github.com/winterqt)
- [@zimbatm](https://github.com/zimbatm)
## How to contact the team
For any GitHub-related needs, you can reach out to the org owners by either:
- Pinging [@NixOS/org](https://github.com/orgs/NixOS/teams/org)
- [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).

### Authority and processes
This team's role is to manage and unblock users of the github.com/NixOS GitHub organization. The @NixOS/steering gives them autonomy to handle small day-to-day tasks and expects them to escalate bigger decisions.

All org owners can individually take care of implementing:
- Decisions by bodies that have the authority to make GitHub org changes such as:
- Arbitrary decisions by the Steering Committee.
- Moderation decisions by the moderation team.
- Changes from approved RFCs.
- Low-impact changes, such as:
- Adding new org members to allow review requests.
- Creating new unprivileged Nixpkgs teams for mention.
- Updating repository meta information.

Org owners need approval from at least one other org owner to take care of implementing
higher-impact changes that are _not controversial_, such as:
- Administer unmaintained repos, such as:
- Performing maintenance.
- Giving commit access to trusted people that offer maintenance.
- Archiving if appropriate.
- Create GitHub apps to unblock automation.
- Changes to the structure and CI of the [org repository](https://github.com/NixOS/org).
- Content updates to the [GitHub organisation documentation](./github.md).

Org owners have no authority to make other changes.

### Responsibilities

- Receive and process requests.
- We expect org owners to be subscribed to the NixOS/org repo.
- Each request should land in at least 2 org owners inboxes of some kind.
- Ensure that all non-trivial and non-sensitive org owner actions are
publicly logged in either of the above channels.
- Escalate requests outside the given authority to the Steering Committee.
- Maintain the [GitHub organisation documentation](./github.md).
- Act as janitor for this repository.
12 changes: 1 addition & 11 deletions doc/github.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,7 @@

The [NixOS GitHub organisation](https://github.com/nixos) and all its repositories is part of the [official resources](./resources.md).

A very small number of people are owners of this GitHub Organisation, and have ultimate permissions over it:
- [@domenkozar](https://github.com/domenkozar)
- [@edolstra](https://github.com/edolstra)
- [@garbas](https://github.com/garbas)
- [@zimbatm](https://github.com/zimbatm)

Furthermore, there is an interim owner to help out:
- [@lassulus](https://github.com/lassulus)

This interim owner is responsible for receiving requests to change anything about the GitHub organisation in the [Github org owners help desk Matrix room](https://matrix.to/#/#org_owners:nixos.org), and either acting upon them or forwarding them to the right person.

The org owners documentation is [here](./github-org-owners.md).

## Repositories

Expand Down

0 comments on commit 7169ff4

Please sign in to comment.