Skip to content

Commit ccef9cb

Browse files
authored
Update labels overview (rust-lang#1639)
1 parent ed855b1 commit ccef9cb

File tree

1 file changed

+91
-55
lines changed

1 file changed

+91
-55
lines changed

Diff for: src/contributing.md

+91-55
Original file line numberDiff line numberDiff line change
@@ -445,66 +445,102 @@ still valid. Load up an older issue, double check that it's still true, and
445445
leave a comment letting us know if it is or is not. The [least recently
446446
updated sort][lru] is good for finding issues like this.
447447

448+
If you're looking for somewhere to start, check out the [E-easy] tag.
449+
448450
[Thanks to `@rustbot`][rustbot], anyone can help triage issues by adding
449451
appropriate labels to issues that haven't been triaged yet:
450452

451-
* Yellow, **A**-prefixed labels state which **area** of the project an issue
452-
relates to.
453-
454-
* Magenta, **B**-prefixed labels identify bugs which are **blockers**.
455-
456-
* Dark blue, **beta-** labels track changes which need to be backported into
457-
the beta branches.
458-
459-
* Light purple, **C**-prefixed labels represent the **category** of an issue.
460-
461-
* Green, **E**-prefixed labels explain the level of **experience** necessary
462-
to fix the issue.
463-
464-
* The dark blue **final-comment-period** label marks bugs that are using the
465-
RFC signoff functionality of [rfcbot] and are currently in the final
466-
comment period.
467-
468-
* Red, **I**-prefixed labels indicate the **importance** of the issue. The
469-
[I-nominated][inom] label indicates that an issue has been nominated for
470-
discussion at the next meeting of the team tagged using a
471-
**T**-prefixed label. Similarly, the [I-prioritize][ipri] indicates
472-
that an issue has been requested to be prioritized by the appropriate
473-
team.
474-
475-
* The purple **metabug** label marks lists of bugs collected by other
476-
categories.
477-
478-
* Purple gray, **O**-prefixed labels are the **operating system** or platform
479-
that this issue is specific to.
480-
481-
* Orange, **P**-prefixed labels indicate a bug's **priority**. These labels
482-
can be assigned by anyone that understand the issue and is able to
483-
prioritize it, and replace the [I-prioritize][ipri] label.
484-
485-
* The gray **proposed-final-comment-period** label marks bugs that are using
486-
the RFC signoff functionality of [rfcbot] and are currently awaiting
487-
signoff of all team members in order to enter the final comment period.
488-
489-
* Pink, **regression**-prefixed labels track regressions from stable to the
490-
release channels.
491-
492-
* The light orange **relnotes** label marks issues that should be documented in
493-
the release notes of the next release.
494-
495-
* Gray, **S**-prefixed labels are used for tracking the **status** of pull
496-
requests.
497-
498-
* Blue, **T**-prefixed bugs denote which **team** the issue belongs to.
499-
500-
If you're looking for somewhere to start, check out the [E-easy][eeasy] tag.
501-
502-
[rustbot]: ./rustbot.md
503-
[inom]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AI-nominated
504-
[ipri]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AI-prioritize
505-
[eeasy]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy
453+
[E-easy]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy
506454
[lru]: https://github.com/rust-lang/rust/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-asc
455+
[rustbot]: ./rustbot.md
456+
457+
<style>
458+
.label-color {
459+
border-radius:0.5em;
460+
}
461+
table td:nth-child(2) {
462+
white-space: nowrap;
463+
}
464+
465+
</style>
466+
467+
| Labels | Color | Description |
468+
|--------|-------|-------------|
469+
| [A-] | <span class="label-color" style="background-color:#f7e101;">&#x2003;</span>&nbsp;Yellow | The **area** of the project an issue relates to. |
470+
| [B-] | <span class="label-color" style="background-color:#d304cb;">&#x2003;</span>&nbsp;Magenta | Issues which are **blockers**. |
471+
| [beta-] | <span class="label-color" style="background-color:#1e76d9;">&#x2003;</span>&nbsp;Dark Blue | Tracks changes which need to be [backported to beta][beta-backport] |
472+
| [C-] | <span class="label-color" style="background-color:#f5f1fd;">&#x2003;</span>&nbsp;Light Purple | The **category** of an issue. |
473+
| [D-] | <span class="label-color" style="background-color:#c9f7a3;">&#x2003;</span>&nbsp;Mossy Green | Issues for **diagnostics**. |
474+
| [E-] | <span class="label-color" style="background-color:#02e10c;">&#x2003;</span>&nbsp;Green | The **experience** level necessary to fix an issue. |
475+
| [F-] | <span class="label-color" style="background-color:#f9c0cc;">&#x2003;</span>&nbsp;Peach | Issues for **nightly features**. |
476+
| [I-] | <span class="label-color" style="background-color:#e10c02;">&#x2003;</span>&nbsp;Red | The **importance** of the issue. |
477+
| [I-\*-nominated] | <span class="label-color" style="background-color:#e10c02;">&#x2003;</span>&nbsp;Red | The issue has been nominated for discussion at the next meeting of the corresponding team. |
478+
| [I-prioritize] | <span class="label-color" style="background-color:#e10c02;">&#x2003;</span>&nbsp;Red | The issue has been nominated for prioritization by the team tagged with a **T**-prefixed label. |
479+
| [metabug] | <span class="label-color" style="background-color:#5319e7;">&#x2003;</span>&nbsp;Purple | Bugs that collect other bugs. |
480+
| [O-] | <span class="label-color" style="background-color:#6e6ec0;">&#x2003;</span>&nbsp;Purple Grey | The **operating system** or platform that the issue is specific to. |
481+
| [P-] | <span class="label-color" style="background-color:#eb6420;">&#x2003;</span>&nbsp;Orange | The issue **priority**. These labels can be assigned by anyone that understand the issue and is able to prioritize it, and remove the [I-prioritize] label. |
482+
| [regression-] | <span class="label-color" style="background-color:#e4008a;">&#x2003;</span>&nbsp;Pink | Tracks regressions from a stable release. |
483+
| [relnotes] | <span class="label-color" style="background-color:#fad8c7;">&#x2003;</span>&nbsp;Light Orange | Changes that should be documented in the release notes of the next release. |
484+
| [S-] | <span class="label-color" style="background-color:#d3dddd;">&#x2003;</span>&nbsp;Gray | Tracks the **status** of pull requests. |
485+
| [S-tracking-] | <span class="label-color" style="background-color:#4682b4;">&#x2003;</span>&nbsp;Steel Blue | Tracks the **status** of [tracking issues]. |
486+
| [stable-] | <span class="label-color" style="background-color:#00229c;">&#x2003;</span>&nbsp;Dark Blue | Tracks changes which need to be [backported to stable][stable-backport] in anticipation of a point release. |
487+
| [T-] | <span class="label-color" style="background-color:#bfd4f2;">&#x2003;</span>&nbsp;Blue | Denotes which **team** the issue belongs to. |
488+
| [WG-] | <span class="label-color" style="background-color:#c2e0c6;">&#x2003;</span>&nbsp;Green | Denotes which **working group** the issue belongs to. |
489+
490+
491+
[A-]: https://github.com/rust-lang/rust/labels?q=A
492+
[B-]: https://github.com/rust-lang/rust/labels?q=B
493+
[C-]: https://github.com/rust-lang/rust/labels?q=C
494+
[D-]: https://github.com/rust-lang/rust/labels?q=D
495+
[E-]: https://github.com/rust-lang/rust/labels?q=E
496+
[F-]: https://github.com/rust-lang/rust/labels?q=F
497+
[I-]: https://github.com/rust-lang/rust/labels?q=I
498+
[O-]: https://github.com/rust-lang/rust/labels?q=O
499+
[P-]: https://github.com/rust-lang/rust/labels?q=P
500+
[S-]: https://github.com/rust-lang/rust/labels?q=S
501+
[T-]: https://github.com/rust-lang/rust/labels?q=T
502+
[WG-]: https://github.com/rust-lang/rust/labels?q=WG
503+
[stable-]: https://github.com/rust-lang/rust/labels?q=stable
504+
[beta-]: https://github.com/rust-lang/rust/labels?q=beta
505+
[I-\*-nominated]: https://github.com/rust-lang/rust/labels?q=nominated
506+
[I-prioritize]: https://github.com/rust-lang/rust/labels/I-prioritize
507+
[tracking issues]: https://github.com/rust-lang/rust/labels/C-tracking-issue
508+
[beta-backport]: https://forge.rust-lang.org/release/backporting.html#beta-backporting-in-rust-langrust
509+
[stable-backport]: https://forge.rust-lang.org/release/backporting.html#stable-backporting-in-rust-langrust
510+
[metabug]: https://github.com/rust-lang/rust/labels/metabug
511+
[regression-]: https://github.com/rust-lang/rust/labels?q=regression
512+
[relnotes]: https://github.com/rust-lang/rust/labels/relnotes
513+
[S-tracking-]: https://github.com/rust-lang/rust/labels?q=s-tracking
514+
515+
### Rfcbot labels
516+
517+
[rfcbot] uses its own labels for tracking the process of coordinating
518+
asynchronous decisions, such as approving or rejecting a change.
519+
This is used for [RFCs], issues, and pull requests.
520+
521+
| Labels | Color | Description |
522+
|--------|-------|-------------|
523+
| [proposed-final-comment-period] | <span class="label-color" style="background-color:#ededed;">&#x2003;</span>&nbsp;Gray | Currently awaiting signoff of all team members in order to enter the final comment period. |
524+
| [disposition-merge] | <span class="label-color" style="background-color:#008800;">&#x2003;</span>&nbsp;Green | Indicates the intent is to merge the change. |
525+
| [disposition-close] | <span class="label-color" style="background-color:#dd0000;">&#x2003;</span>&nbsp;Red | Indicates the intent is to not accept the change and close it. |
526+
| [disposition-postpone] | <span class="label-color" style="background-color:#ededed;">&#x2003;</span>&nbsp;Gray | Indicates the intent is to not accept the change at this time and postpone it to a later date. |
527+
| [final-comment-period] | <span class="label-color" style="background-color:#1e76d9;">&#x2003;</span>&nbsp;Blue | Currently soliciting final comments before merging or closing. |
528+
| [finished-final-comment-period] | <span class="label-color" style="background-color:#f9e189;">&#x2003;</span>&nbsp;Light Yellow | The final comment period has concluded, and the issue will be merged or closed. |
529+
| [postponed] | <span class="label-color" style="background-color:#fbca04;">&#x2003;</span>&nbsp;Yellow | The issue has been postponed. |
530+
| [closed] | <span class="label-color" style="background-color:#dd0000;">&#x2003;</span>&nbsp;Red | The issue has been rejected. |
531+
| [to-announce] | <span class="label-color" style="background-color:#ededed;">&#x2003;</span>&nbsp;Gray | Issues that have finished their final-comment-period and should be publicly announced. Note: the rust-lang/rust repository uses this label differently, to announce issues at the triage meetings. |
532+
533+
[disposition-merge]: https://github.com/rust-lang/rust/labels/disposition-merge
534+
[disposition-close]: https://github.com/rust-lang/rust/labels/disposition-close
535+
[disposition-postpone]: https://github.com/rust-lang/rust/labels/disposition-postpone
536+
[proposed-final-comment-period]: https://github.com/rust-lang/rust/labels/proposed-final-comment-period
537+
[final-comment-period]: https://github.com/rust-lang/rust/labels/final-comment-period
538+
[finished-final-comment-period]: https://github.com/rust-lang/rust/labels/finished-final-comment-period
539+
[postponed]: https://github.com/rust-lang/rfcs/labels/postponed
540+
[closed]: https://github.com/rust-lang/rfcs/labels/closed
541+
[to-announce]: https://github.com/rust-lang/rfcs/labels/to-announce
507542
[rfcbot]: https://github.com/anp/rfcbot-rs/
543+
[RFCs]: https://github.com/rust-lang/rfcs
508544

509545
## Out-of-tree Contributions
510546

0 commit comments

Comments
 (0)