Skip to content

[Docs] Introduce backend maintainer roles #674

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
sknepper merged 3 commits into from
Jul 14, 2025
Merged

[Docs] Introduce backend maintainer roles #674

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
97e68e8
[Docs] Introduce backend maintainer roles
sknepper May 13, 2025
7a53e6a
[Docs] Adjust backend maintainer requirements based on review feedback
sknepper May 22, 2025
a33ecfc
[Docs] Add backend maintainers to CODEOWNERS
sknepper May 22, 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
5 changes: 5 additions & 0 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,11 @@ For GitHub questions, issues, RFCs, or PRs you can contact maintainers via one o
| @uxlfoundation/onemath-rng-write | oneMath RNG maintainers |
| @uxlfoundation/onemath-sparse-write | oneMath Sparse Algebra maintainers |
| @uxlfoundation/onemath-vm-write | oneMath Vector Math maintainers |
| @uxlfoundation/onemath-cpu-aarch64 | AArch64 CPU maintainers |
| @uxlfoundation/onemath-cpu-x64 | x86 CPU maintainers |
| @uxlfoundation/onemath-gpu-amd | AMD GPU maintainers |
| @uxlfoundation/onemath-gpu-intel | Intel GPU maintainers |
| @uxlfoundation/onemath-gpu-nvidia | NVIDIA GPU maintainers |

Please read [MAINTAINERS page](MAINTAINERS.md) for more information about maintainer roles, responsibilities, and how to become one of them.

Expand Down
73 changes: 61 additions & 12 deletions MAINTAINERS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,10 @@ This document defines roles in oneMath project.

# Roles and responsibilities

oneMath project defines three main roles:
oneMath project defines four main roles:
* [Contributor](#contributor)
* [Domain maintainer](#domain-maintainer)
* [Backend maintainer](#backend-maintainer)
* [Architecture maintainer](#architecture-maintainer)

These roles are merit based. Refer to the corresponding section for specific
Expand Down Expand Up @@ -44,7 +45,7 @@ Responsibilities:
* Follow and enforce the project [contributing guidelines](CONTRIBUTING.md).
* Co-own with other domain maintainers a specific domain, including contributing
bug fixes, implementing features, and answering domain specific questions
in [#onemkl](https://uxlfoundation.slack.com/archives/onemkl) Slack channel.
in [#onemath](https://uxlfoundation.slack.com/archives/onemath) Slack channel.
* Review pull requests in their specific domain.
* Monitor testing results and flag issues in their specific areas of
responsibility.
Expand All @@ -66,7 +67,7 @@ Privileges:

The process of becoming a Domain maintainer is:
1. A Contributor requests to join corresponding Domain maintainer GitHub team.
2. At least one specific Domain maintainers approve the request.
2. At least one specific Domain maintainer approves the request.

### List of GitHub teams for Domain maintainers

Expand All @@ -79,6 +80,53 @@ The process of becoming a Domain maintainer is:
| @uxlfoundation/onemath-sparse-write | oneMath Sparse Algebra maintainers |
| @uxlfoundation/onemath-vm-write | oneMath Vector Math maintainers |

## Backend Maintainer

Backend maintainer has responsibility for a specific backend in the project.
Backend maintainers are collectively responsible for developing and maintaining their backends,
including reviewing certain changes to their backend and indicating
whether those changes are ready to merge. They have a track record of
contribution and review in the project.

Responsibilities:
* Follow the [Code of Conduct](CODE_OF_CONDUCT.md).
* Follow and enforce the project [contributing guidelines](CONTRIBUTING.md).
* Co-own with other backend maintainers a specific backend, including contributing
bug fixes, implementing features, and answering backend specific questions
in [#onemath](https://uxlfoundation.slack.com/archives/onemath) Slack channel.
* Review pull requests pertaining to their specific backend.
* Monitor testing results and flag issues in their specific areas of
responsibility.
* Support and guide Contributors.

Requirements:
* Experience as Contributor in the specific backend for at least 6 months.
* Commit at least 25% of working time to the project.
Copy link

@rodburns rodburns May 14, 2025

Choose a reason for hiding this comment

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

Should we include this requirement, or just use the one below that says "Commits to being responsible for that specific backend" ?

Copy link
Contributor Author

@sknepper sknepper May 22, 2025

Choose a reason for hiding this comment

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

Good point! Removed the 25% commitment as likely there would not be as much work required for backend maintainers.

* Track record of accepted code contributions to a specific backend.
* Track record of contributions to the code review process.
* Demonstrated in-depth knowledge of the specific backend.
* Commits to being responsible for that specific backend.

Privileges:
* PR approval counts towards approval requirements for a specific backend.
* Can promote fully approved Pull Requests to the `develop` branch.
* Can recommend Contributors to become Backend maintainers.
* Eligible to become an Architecture maintainer.

The process of becoming a Backend maintainer is:
1. A Contributor requests to join corresponding Backend maintainer GitHub team.
2. At least one specific Backend maintainer approves the request.

### List of GitHub teams for Backend maintainers

| GitHub team name | Backend maintainers |
:-----------|:------------|
| @uxlfoundation/onemath-cpu-aarch64 | AArch64 CPU maintainers |
| @uxlfoundation/onemath-cpu-x64 | x86 CPU maintainers |
| @uxlfoundation/onemath-gpu-amd | AMD GPU maintainers |
| @uxlfoundation/onemath-gpu-intel | Intel GPU maintainers |
| @uxlfoundation/onemath-gpu-nvidia | NVIDIA GPU maintainers |

## Architecture Maintainer
Architecture maintainers are the most established contributors who are responsible for the
project technical direction and participate in making decisions about the
Expand All @@ -88,26 +136,27 @@ Responsibilities:
* Follow the [Code of Conduct](CODE_OF_CONDUCT.md).
* Follow and enforce the project [contributing guidelines](CONTRIBUTING.md)
* Co-own with other Domain maintainers on the technical direction of a specific domain.
* Co-own with other Backend maintainers on the support and implementation of a specific backend.
* Co-own with other Architecture maintainers on the project as a whole, including
determining strategy and policy for the project.
* Support and guide Contributors and Domain maintainers.
determining strategy and policy for the project.
* Support and guide Contributors, Domain maintainers, and Backend maintainers.

Requirements:
* Experience as a Domain maintainer or Contributor with focus on the project architecture
for at least 12 months.
* Experience as a Domain or Backend maintainer or Contributor with focus on the project
architecture for at least 12 months.
* Commit at least 25% of working time to the project.
* Track record of major project contributions.
* Demonstrated deep knowledge of the project architecture and build.
* Demonstrated broad knowledge of the project across multiple domains.
* Demonstrated broad knowledge of the project across multiple domains and/or multiple backends.
* Is able to exercise judgment for the good of the project, independent of
their employer, friends, or team.

Privileges:
* Can represent the project in public as a Maintainer.
* Can recommend Contributor or Domain maintainer to become Architecture maintainers.
* Can recommend Contributor, Domain maintainer, or Backend maintainer to become Architecture maintainer.

Process of becoming a maintainer:
1. A Contributor or Domain maintainer requests to join oneMath Architecture maintainers GitHub team
(@uxlfoundation/onemath-arch-write).
2. At least one of Architecture maintainers approves the request.
1. A Contributor, Domain maintainer, or Backend maintainer requests to join oneMath Architecture
maintainers GitHub team (@uxlfoundation/onemath-arch-write).
2. At least one of the existing Architecture maintainers approves the request.

Loading