mirror of
https://github.com/Homebrew/brew.git
synced 2025-07-14 16:09:03 +08:00
8f75f66d01
- Most of these were fine still, apart from: - FAQ: `hub` is less maintained than `gh`. - Brew-Maintainer-Guide: link to GitHub docs on commit signing via GPG or SSH. - Interesting-Taps-and-Forks: remove outdated information about `homebrew/core` being in `Library/Taps`. - New-Maintainer-Checklist: remove outdated information about the `@members` team.
62 lines
2.7 KiB
Markdown
62 lines
2.7 KiB
Markdown
---
|
||
last_review_date: "2025-02-08"
|
||
---
|
||
|
||
# Maintainers: Avoiding Burnout
|
||
|
||
**This guide is for maintainers.** These special people have **write
|
||
access** to Homebrew’s repository and help merge the contributions of
|
||
others. You may find what is written here interesting, but it’s
|
||
definitely not for everyone.
|
||
|
||
## 1. Use Homebrew
|
||
|
||
Maintainers of Homebrew should be using it regularly. This is partly because
|
||
you won't be a good maintainer unless you can put yourself in the shoes of our
|
||
users, but also because you may decide to stop using Homebrew and at that point
|
||
you should also decide not to be a maintainer and find other things to work on.
|
||
|
||
## 2. No Guilt About Leaving
|
||
|
||
All maintainers can stop working on Homebrew at any time without any guilt or
|
||
explanation (like leaving a job). We may still ask for your help with questions
|
||
after you leave but you are under no obligation to answer them. Like a job, if
|
||
you create a big mess and then leave you still have no obligations but we may
|
||
think less of you (or, realistically, probably just revert the problematic
|
||
work). Like a job, you should probably take a break from Homebrew at least a few
|
||
times a year.
|
||
|
||
This also means contributors should be consumers. If an owner finds they are
|
||
not using a project in the real world, they should reconsider their involvement
|
||
with the project.
|
||
|
||
## 3. Prioritise Maintainers Over Users
|
||
|
||
It's important to be user-focused but ultimately, as long as you follow #1
|
||
above, Homebrew's minimum number of users will be the number of maintainers.
|
||
However, if Homebrew has no maintainers it will quickly become useless to all
|
||
users and the project will die. As a result, no user complaint, behaviour or
|
||
need takes priority over the burnout of maintainers. If users do not like the
|
||
direction of the project, the easiest way to influence it is to make
|
||
significant, high-quality code contributions and become a maintainer.
|
||
|
||
## 4. Learn To Say No
|
||
|
||
Homebrew gets a lot of feature requests, non-reproducible bug reports, usage
|
||
questions and PRs we won't accept. These should be closed out as soon as we
|
||
realise that they aren't going to be resolved or merged. This is kinder than
|
||
deciding this after a long period of review. Our issue tracker should reflect
|
||
work to be done.
|
||
|
||
## 5. Slow Down
|
||
|
||
We're a volunteer-run open source project used by a lot of people. That can mean
|
||
that it feels like there's a lot of pressure to get a fix, package or project
|
||
completed ASAP. Try to not feel this pressure; slow down, focus on Homebrew
|
||
being enjoyable. If in doubt: over-communicate your decision making. A revert
|
||
can always be done now and a proper fix done tomorrow.
|
||
|
||
---
|
||
|
||
_Thanks to <https://gist.github.com/ryanflorence/124070e7c4b3839d4573> which influenced this document._
|