Skip to content

Commit 76f95a1

Browse files
docs: add maintainer expectations to MAINTAINERS.md (#5514)
1 parent 76d7194 commit 76f95a1

File tree

1 file changed

+26
-4
lines changed

1 file changed

+26
-4
lines changed

MAINTAINERS.md

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,9 +90,8 @@ Your public behavior, whether in the physical or virtual world, reflects upon th
9090
> If you don't understand the code of conduct, or why it exists, it is _your responsibility_ to educate yourself.
9191
> This does not imply the CoC is immutable.
9292
93-
Furthermore, a maintainer is a contributor who **contributes regularly**, or expresses a _desire to do so._ That could be every day--but it might be once a week, or even once a month.
94-
Your boss doesn't work here; contribute as often as you wish.
95-
We are all people with Real Lives, and for many of us, contributing to OSS is just a hobby!
93+
Furthermore, a maintainer is a contributor who **contributes regularly**. That can be daily, weekly, or even just a few times a month -- as long as it's regular.
94+
We are all people with Real Lives, and for many of us, contributing to OSS is just an occasional hobby!
9695

9796
Finally, a maintainer must help define what makes Mocha "Mocha".
9897
At minimum, a maintainer must _understand_ the current definition (if a maintainer is not interested in decision-making).
@@ -108,7 +107,7 @@ As maintainers, _we work together_ to learn about the nature of these questions.
108107

109108
A maintainer _must_ also have 2FA enabled on their GitHub account.
110109

111-
> If you think that you aren't familiar with mocha's internals enough to contribute, please watch [This walkthrough video!](https://youtu.be/zLayCLcIno0)
110+
> If you think that you aren't familiar with mocha's internals enough to contribute, please watch [this walkthrough video](https://youtu.be/zLayCLcIno0)!
112111
113112
#### The Rights of a Maintainer
114113

@@ -127,6 +126,28 @@ You may choose to do zero or more of these _at their discretion_:
127126
> For example, a spelling correction in `CHANGELOG.md` may not require a pull request.
128127
> A change to a reporter's output most certainly would! Maintainers are trusted to use their best judgement; if unsure, err on the side of caution.
129128
129+
#### Expected Activity Levels
130+
131+
We generally expect maintainers to average at least:
132+
133+
- Multiple contributions of any kind in a week
134+
- One meaningful, non-trivial contribution per month
135+
136+
These are rough averages, not strict minimums!
137+
It's totally fine to skip a week or two here and there, as long as you do a little more before or after.
138+
Meaningful, non-trivial contributions can be a well-thought-out comment, sending a non-straightforward pull request, or anything else that adds real value to the project.
139+
140+
If you have to step away longer than a couple of weeks, that's totally fine too.
141+
Just let the other maintainers know ahead of time.
142+
143+
- If you need to step away for up to a month or two, don't sweat it.
144+
- If we don't hear from you for a month without prior notice, we'll check in with you to see if you want to remain a maintainer.
145+
- After three months of inactivity, or two without prior notice, we'll likely remove you as a maintainer.
146+
147+
Again, don't stress about this if you can't always be available.
148+
Your boss doesn't work here; contribute as often as you reasonably can.
149+
Even if you step down or are removed, if you can come back and be regularly active we'll happily reinstate you.
150+
130151
#### About "Owners"
131152

132153
Some maintainers will have full admin rights to the [mochajs org](https://github.com/mochajs) and/or will have access to publish to npm.
@@ -142,6 +163,7 @@ If that fails, we decide by a simple vote.
142163

143164
Active maintainers will make an effort to solicit feedback from others before making important or potentially controversial decisions.
144165
Given the varying geographical distribution and availability of the maintenance team, we resolve to do the best we can to solicit feedback.
166+
We will wait at least two weeks for consensus votes in most cases, and a month for especially important decisions.
145167

146168
In other words, to have your opinion heard, participate regularly.
147169
The rest of the team won't wait on feedback that isn't necessarily forthcoming!

0 commit comments

Comments
 (0)