Skip to content

Commit 6aec7e7

Browse files
solejasonLaster
authored andcommitted
Rename up for grabs with available (firefox-devtools#2400)
* Rename `up for grabs` with `available` as discussed in https://groups.google.com/forum/#!topic/mozilla.dev.developer-tools/ZtGZdelWt7o * Followed suggestion from @jasonLaster and edited to use `available` rather than `actionable`
1 parent cd1d1b6 commit 6aec7e7

3 files changed

Lines changed: 22 additions & 22 deletions

File tree

CONTRIBUTING.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -115,8 +115,9 @@ We are lucky to have lots of [nice people][getting-help] here.
115115
#### Your First Code Contribution
116116

117117
If you're looking for a good issue, you can look through
118-
the [up-for-grabs][labels-up-for-grabs] issues.
119-
These issues should be actionable and well documented.
118+
the [available][labels-available] issues.
119+
120+
These issues should be well documented.
120121

121122
To begin your work make sure you follow these steps:
122123

@@ -154,7 +155,7 @@ Go to [local Development](./docs/local-development.md) to learn about:
154155
* [Issue Descriptions](./docs/issues.md#issue-descriptions)
155156
* [Claiming Issues](./docs/issues.md#claiming-issues)
156157
* [Labels](./docs/issues.md#labels)
157-
* [Up For Grab Issues](./docs/issues.md#up-for-grab-issues)
158+
* [Available Issues](./docs/issues.md#available-issues)
158159
* [Triaging](./docs/issues.md#triaging)
159160
* [Issue Organization](./docs/issues.md#issue-organization)
160161
* [Community Friendly](./docs/issues.md#community-friendly)
@@ -243,7 +244,7 @@ Mozilla has and continues to hire many people from within the Open Source Softwa
243244
**Referrals**. If you’ve been making reasonable and regular contributions to the project we’d be happy to be a reference for you. We can make internal referrals to Mozilla or act as your reference to other companies. Please be considerate when making this request, we are happy to help you and want to see you find a job you want but can’t do this for everyone who contributes.
244245

245246
[getting-setup]:./docs/getting-setup.md
246-
[labels-up-for-grabs]:https://github.com/devtools-html/debugger.html/labels/up%20for%20grabs
247+
[labels-available]:https://github.com/devtools-html/debugger.html/labels/available
247248
[labels-first-timers-only]:https://github.com/devtools-html/debugger.html/labels/first-timers-only
248249
[labels-difficulty-easy]:https://github.com/devtools-html/debugger.html/labels/difficulty%3A%20easy
249250
[labels-difficulty-medium]:https://github.com/devtools-html/debugger.html/labels/difficulty%3A%medium

docs/issues.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
* [Issue Descriptions](#issue-descriptions)
55
* [Claiming Issues](#claiming-issues)
66
* [Labels](#labels)
7-
* [Up For Grab Issues](#up-for-grab-issues)
7+
* [Available Issues](#available-issues)
88
* [Triaging](#triaging)
99
* [Issue Organization](#issue-organization)
1010
* [Community Friendly](#community-friendly)
@@ -101,7 +101,7 @@ These are the [labels](https://github.com/devtools-html/debugger.html/labels) we
101101

102102
| Label name | query:mag_right: | Description |
103103
| --- | --- | --- |
104-
| `up-for-grabs` | [search][labels-up-for-grabs] | Good for contributors to work on |
104+
| `available` | [search][labels-available] | Good for contributors to work on |
105105
| `difficulty:easy` | [search][labels-difficulty-easy] | Work that is small changes, updating tests, updating docs, expect very little review |
106106
| `difficulty:medium` | [search][labels-difficulty-medium] | Work that adapts existing code, adapts existing tests, expect quick review |
107107
| `difficulty:hard` | [search][labels-difficulty-hard] | Work that requires new tests, new code, and a good understanding of project; expect lots of review |
@@ -114,15 +114,14 @@ These are the [labels](https://github.com/devtools-html/debugger.html/labels) we
114114
| `infrastructure` | [search][labels-infrastructure] | Issues with testing / build infrastructure |
115115
| `discussion` | [search][labels-discussion] | Issues need clearer requirements before work can be started |
116116

117-
### Up For Grab Issues
117+
### Available Issues
118118

119-
[up for grabs][labels-up-for-grabs] issues have clear requirements and a difficulty level.
119+
[available][labels-available] issues have clear requirements and a difficulty level.
120120

121121
They often have a patch, which should be a good starting off point.
122122
Sometimes the patches are enough to fix the bug!
123123

124-
One reason we file up for grabs issues when the solution is somewhat simple is that it's great to get a second
125-
set of eyes. Running the fix locally and QAing it thoroughly is a huge help. A lot of times you'll discover things that we missed.
124+
One reason we file `available` issues when the solution is somewhat simple is that it's great to get a second set of eyes. Running the fix locally and QAing it thoroughly is a huge help. A lot of times you'll discover things that we missed.
126125

127126
### Triaging
128127

@@ -131,10 +130,10 @@ It's one of the most helpful ways to help a project.
131130

132131
There are a couple of ways to think about it:
133132
* it's great to be able to close issues that are done or stale
134-
* it's great to make issue descriptions as clear as possible. Our goal is for every issue to be *actionable* i.e. it's clear what needs to be done.
133+
* it's great to make issue descriptions as clear as possible. Our goal is for every issue to be `available` i.e. it's clear what needs to be done.
135134
* it's really helpful to double check a new bug and see if you can reproduce it.
136-
* it's great to ask questions that help make the issue actionable or call out vague issues.
137-
* it's great to sort the issues by oldest first and help make stale issues actionable.
135+
* it's great to ask questions that help make the issue available or call out vague issues.
136+
* it's great to sort the issues by oldest first and help make stale issues available.
138137

139138
### Issue Organization
140139

@@ -152,7 +151,7 @@ We focus on being community friendly for many reasons.
152151
* There's an incredible diversity of talent to help us with topics ranging from testing to internationalization.
153152
* Focusing on *contributor experience* helps us build the best development environment. For instance, if you find it's hard to describe how to make an accessibility change, maybe we should improve how we support tab navigation.
154153

155-
[labels-up-for-grabs]:https://github.com/devtools-html/debugger.html/labels/up%20for%20grabs
154+
[labels-available]:https://github.com/devtools-html/debugger.html/labels/available
156155
[labels-first-timers-only]:https://github.com/devtools-html/debugger.html/labels/first-timers-only
157156
[labels-difficulty-easy]:https://github.com/devtools-html/debugger.html/labels/difficulty%3A%20easy
158157
[labels-difficulty-medium]:https://github.com/devtools-html/debugger.html/labels/difficulty%3A%medium

docs/maintainer.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,22 +10,22 @@ Helping maintain a project is the best way to contribute to its overall health.
1010

1111
#### Closing Stale Issues
1212

13-
We define *stale* as issues that are 30 days or older. Stale is often an indicator of another issue: it is unecessary, too vague, too broad, or a low priority.
13+
We define *stale* as issues that are 30 days or older. Stale is often an indicator of another issue: it is unnecessary, too vague, too broad, or a low priority.
1414

15-
* *unecessary* - close it
16-
* *vague* - clarify the issue and make it more actionable
15+
* *unnecessary* - close it
16+
* *vague* - clarify the issue and make it more available
1717
* *broad* - create more focused issues, such as "add flow types to `WhyPaused` component"
1818
* *low priority* - close it and add it to the [enhancements board]
1919

20-
#### Making Issues Actionable a.k.a "Up for Grabs"
20+
#### Making Issues `available`
2121

22-
Actionable is short for two things:
22+
Available is short for two things:
2323

2424
1. a clearly defined specification (end-state)
2525
2. a clear implementation plan
2626

27-
Our goal is to have 100% of our issues actionable or blocked by another actionable ticket.
28-
If you find an issue that is not actionable you can:
27+
Our goal is to have 100% of our issues available or blocked by another available ticket.
28+
If you find an issue that is not available you can:
2929

3030
1. investigate the issue and answer questions that you have
3131
2. share questions or offer reasonable solutions that can be implemented
@@ -56,7 +56,7 @@ I recommend [ship] for tracking issues.
5656

5757
Patches are a great way to clarify what work needs to be done.
5858

59-
Patches on "up for grabs" issues help clarify where the code should go and are often clearer than english.
59+
Patches on `available` issues help clarify where the code should go and are often clearer than English.
6060

6161
Tips:
6262

0 commit comments

Comments
 (0)