contributor docs: Improve outreach programs prioritization documentation.

This commit is contained in:
Alya Abbott 2024-05-20 14:35:59 -07:00
parent f39e4e8087
commit 3aa345b4c6
1 changed files with 34 additions and 25 deletions

View File

@ -201,6 +201,8 @@ In practice, this means that over the course of the program, you will:
questions about what to tackle next in your
[check-ins](#how-to-post-your-check-ins).
- Use GitHub project boards to understand current priorities.
- Like other Zulip contributors, [claim
issues](../contributing/contributing.md#claiming-an-issue) only when you
actually start work on them.
@ -234,35 +236,16 @@ Always keep the following order of priorities in mind:
6. Finally, if all of the above are in good shape, **find a new issue** to pick up!
### What about my proposal?
We have a fluid approach to planning, which means you are very unlikely to end
up working on the exact set of issues described in your proposal. Your proposal
is not a strict commitment (on either side).
### Finding issues to pick up
In terms of managing your work:
You can use the following process to find a new issue to work on:
- Regardless of whether an issue was mentioned in your proposal, make
sure you bring it up in your check-ins when you plan to start
working on something. Project priorities shift over time, and we
may have suggestions for higher-priority work in your area of
interest, or issues that will serve as good preparation for other
work you are excited about. It's also possible that a project idea
is not ready to be worked on, or needs to be sequenced after other projects.
1. Check the issue tracker for bugs in the parts of the codebase you've been
working in. Bugs and polish
make a huge difference to our users' experience. If you can put up a clean PR
- When asking for recommendations for what to work on next, it's helpful to
include a reminder of what areas you're most excited about, especially early
on in the program when we're still getting to know you. Do not expect program
administrators to remember what issues were listed in your proposal.
While some program participants stick closely to the spirit of their proposal,
others find new areas they are excited about in the course of their work. You
can be highly successful in the program either way!
### Tips for finding issues to pick up
- Look for, claim, and fix bugs to help keep Zulip polished. Bugs and polish
make a huge difference to our users' experience. If you can fix a
- Look for, claim, and fix bugs to help keep Zulip polished. B If you can fix a
[high-priority
bug](https://github.com/zulip/zulip/issues?page=2&q=is%3Aopen+is%3Aissue+label%3Abug+label%3A%22priority%3A+high%22)
in an area you've been working on, it is likely to have more impact than any
@ -295,6 +278,32 @@ waiting for a question to be answered or for the next round of feedback on a PR:
preparatory refactoring that will make the feature easier to complete and can
already be merged.
### What about my proposal?
We have a fluid approach to planning, which means you are very unlikely to end
up working on the exact set of issues described in your proposal. Your proposal
is not a strict commitment (on either side).
In terms of managing your work:
- Regardless of whether an issue was mentioned in your proposal, make
sure you bring it up in your check-ins when you plan to start
working on something. Project priorities shift over time, and we
may have suggestions for higher-priority work in your area of
interest, or issues that will serve as good preparation for other
work you are excited about. It's also possible that a project idea
is not ready to be worked on, or needs to be sequenced after other projects.
- When asking for recommendations for what to work on next, it's helpful to
include a reminder of what areas you're most excited about, especially early
on in the program when we're still getting to know you. Do not expect program
administrators to remember what issues were listed in your proposal.
While some program participants stick closely to the spirit of their proposal,
others find new areas they are excited about in the course of their work. You
can be highly successful in the program either way!
## How else can I contribute?
- Participate and be helpful in the community! Helping a new contributor get