Skip to content

github-org-owners: perform copy editing #195

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.

Sign up for GitHub

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

Merged
roberth merged 3 commits into from
Nov 6, 2025
Merged

github-org-owners: perform copy editing #195

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
aaf0f9a
github-org-owners: perform copy editing
philiptaron Nov 5, 2025
8ad729b
github-org-owners: link the organization
philiptaron Nov 5, 2025
0ab9642
github-org-owners: adjust wording on how administering repositories c…
philiptaron Nov 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 9 additions & 10 deletions doc/github-org-owners.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ For any GitHub-related needs, you can reach out to the org owners by either:
- Messaging in the [Github org owners help desk Matrix room](https://matrix.to/#/%23org_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.
This team's role is to manage and unblock users of the [NixOS GitHub organization](https://github.com/NixOS).
They have autonomy to handle small day-to-day tasks and the expectation they will escalate bigger decisions to the Steering Committee.

All org owners can individually take care of implementing:
- Decisions by bodies that have the authority to make GitHub org changes such as:
Expand All @@ -30,17 +31,16 @@ All org owners can individually take care of implementing:
- Updating repository meta information.
- Changes requested by a repository admin that have no impact outside their repository.

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:
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:
- Administering unmaintained repos, such as by:
- Performing maintenance.
- Giving commit access to trusted people that offer maintenance.
- Archiving if appropriate.
- Changes necessary 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).
- Making changes necessary to unblock automation.
- Making changes to the structure and CI of the [org repository](https://github.com/NixOS/org).
- Authoring content updates to the [GitHub organisation documentation](./github.md).

Org owners have no authority to make other changes.
Org owners do not have authority to make other changes.

### Responsibilities

Expand All @@ -50,8 +50,7 @@ Org owners have no authority to make other changes.
- 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.
- 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.