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

Require Maintainers to be Triagers #347

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

Conversation

booxter
Copy link
Contributor

@booxter booxter commented Aug 8, 2024

The project is looking for ways to improve community relationships, and one of the suggestions is to require maintainers to share triager responsibilities to provide timely and useful feedback to contributors on their issues and pull requests.

The proposal is to assume privileges and responsibilities and membership is monotonically expanding so that:

  • all triagers are members (already the case);
  • all maintainers are triagers (this proposal).

Or if these were python sets, then... ;)

Contributor <= Member <= Triager <= Maintainer

Context: we are considering automatic assignment of a number of Triagers to every new pull request, and it's important that this burden is shared by all seasoned members, incl. maintainers.

Note: once this is approved, someone should walk through the list of current Maintainers and add them to Triagers groups for appropriate repos. Alternatively, Maintainers groups can be converted into nested groups, see:

https://docs.github.com/en/organizations/organizing-members-into-teams/about-teams#nested-teams

@booxter booxter requested a review from a team as a code owner August 8, 2024 18:10
@nathan-weinberg nathan-weinberg requested a review from a team August 8, 2024 18:11
@jjasghar
Copy link
Member

jjasghar commented Aug 8, 2024

I understand the idea here, but right now, (and going forward) Triagers are going to be a very different group of people. The requirements for the knowledge submissions will change the...drive to be triagers now, and with that overhead and being part of other portions of this project it maybe overwhelming.

@nathan-weinberg
Copy link
Member

@jjasghar this isn't in reference to the Taxonomy Triagers, it's to the Contributor Role of Triagers defined here: https://github.com/instructlab/community/blob/main/CONTRIBUTOR_ROLES.md#triager

@jjasghar
Copy link
Member

jjasghar commented Aug 8, 2024

Oh! Sorry miss understood.

@nathan-weinberg
Copy link
Member

@jjasghar No worries! It's an unfortunate collision of terms 😄

CONTRIBUTOR_ROLES.md Outdated Show resolved Hide resolved
The project is looking for ways to improve community relationships, and
one of the suggestions is to require maintainers to share triager
responsibilities to provide timely and useful feedback to contributors
on their issues and pull requests.

The proposal is to assume privileges and responsibilities and membership
is monotonically expanding so that:

- all triagers are members (already the case);
- all maintainers are triagers (this proposal).

Or if these were python sets, then... ;)

```
Contributor <= Member <= Triager <= Maintainer
```

Context: we are considering automatic assignment of a number of Triagers
to every new pull request, and it's important that this burden is shared
by all seasoned members, incl. maintainers.

Note: once this is approved, someone should walk through the list of
current Maintainers and add them to Triagers groups for appropriate
repos. Alternatively, Maintainers groups can be converted into nested
groups, see:

https://docs.github.com/en/organizations/organizing-members-into-teams/about-teams#nested-teams

Signed-off-by: Ihar Hrachyshka <[email protected]>
Copy link
Member

@markstur markstur left a comment

Choose a reason for hiding this comment

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

This is a "community" roles doc and not just CLI, so...

taxonomy is actually using triagers and needs that distinction, where CLI hasn't really been doing that. I think the change here breaks their model (a little?) just to try to address our attempt at a better way. That's not good in "community".

So I think:

1 - If this change is CLI only, then add these notes saying that's the case.
2 - If we are actually going to put folks in both maintainers and triagers then this doc change is pretty much not needed. If I'm in both, I'm expected to perform both roles. `nuff said, right? But sure... some note saying we intend to have all CLI maintainers in both would be worth noting right now for clarity.

Lastly, I support the re-group thinking effort to make us better and put all maintainers in triagers (either explicitly or perhaps if it is implied for now that could work too)... but I think long-term it is likely that some maintainers might have more specific roles (e.g. maybe a maintainer that is a security specialist) and so maybe all would not be best suited to be tagged as a generic triager. Not a problem in the short-term, but maybe others agree and have thoughts on how that affects this proposal.

@nathan-weinberg
Copy link
Member

This is a "community" roles doc and not just CLI, so...

taxonomy is actually using triagers and needs that distinction, where CLI hasn't really been doing that. I think the change here breaks their model (a little?) just to try to address our attempt at a better way. That's not good in "community".

So I think:

1 - If this change is CLI only, then add these notes saying that's the case.

This is not for CLI only - triagers is a defined org-level team role and also it is something that exists for the CLI repo as well as several others

2 - If we are actually going to put folks in both maintainers and triagers then this doc change is pretty much not needed. If I'm in both, I'm expected to perform both roles. `nuff said, right? But sure... some note saying we intend to have all CLI maintainers in both would be worth noting right now for clarity.

Right now it's ambiguous - I think it's worth defining it one way or the other.

Lastly, I support the re-group thinking effort to make us better and put all maintainers in triagers (either explicitly or perhaps if it is implied for now that could work too)... but I think long-term it is likely that some maintainers might have more specific roles (e.g. maybe a maintainer that is a security specialist) and so maybe all would not be best suited to be tagged as a generic triager. Not a problem in the short-term, but maybe others agree and have thoughts on how that affects this proposal.

Good point!

@caradelia
Copy link
Contributor

I would recommend this PR be brought up as an agenda item in the next Community Mtg to discuss to create awareness and get more input from the community.

@@ -115,9 +115,13 @@ Maintainers will vote publicly on the issue, expressing their support via a GitH

After a [decision has been made](https://github.com/instructlab/community/blob/main/governance.md#decision-making-at-the-instructlab-org-level), a Maintainer will create a PR to add you in the [MAINTAINER file](https://github.com/instructlab/community/blob/main/MAINTAINERS.md) within three weeks.

All Maintainers are Triagers. If a candidate is not a Triager at the time of the nomination, they should be added to both Triagers and Maintainers teams.
Copy link
Member

Choose a reason for hiding this comment

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

Is this saying that you can nominate a user to be a maintainer without them serving as a triager? Does this circumvent the contributor ladder?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I agree the ladder should be - at least as a rule - followed in steps. But.

AFAIU nothing in the ladder or this document forbids this from happening now. See the line 102 - the only thing required is being a Member for a month. If we think a Triager requirement (time-bound or a general one) is needed, we can update the document to reflect it accordingly, but that is not the goal of this PR. The goal here is to make sure that Maintainers are always Triagers.

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.

7 participants