Skip to content

Commit 8968f78

Browse files
committed
add "Team Roles" section to "Issue Triage" page
1 parent 1edc5e0 commit 8968f78

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

src/release/issue-triaging.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ Note that some labels may only be applied by users with write access to [`rust-l
8080
There are many different labels that can be applied to issues.
8181

8282
- `needs-triage`: Signals that an issue is new and needs initial triage.
83-
- [`T-*`]: Specifies the team or teams that this issue is relevant to. For example `T-compiler`, `T-types` or `T-libs`.
83+
- [`T-*`]: Specifies the team or teams that this issue is relevant to. For example `T-compiler`, `T-types` or `T-libs`. See [Team Roles](#team-roles) for more details.
8484
- [`WG-*`]: Specifies the working groups that this issue is relevant to, for example `WG-debugging`.
8585
- [`PG-*`]: Specifies the project groups that this issue is relevant to, for example the `PG-exploit-mitigations`.
8686
- [`C-*`]: Specifies the category of the label, for example a bug, tracking issue or discussion.
@@ -145,6 +145,26 @@ There are many different labels that can be applied to issues.
145145
- An FCP will also cause a relnotes issue to be created, if it's started on an issue.
146146
- [`metabug`]: Tracks other bugs.
147147

148+
#### Team roles
149+
150+
Most of the teams have fairly obvious roles,
151+
like `T-compiler` handling everything related to the compiler,
152+
but some teams are less self-explantory.
153+
154+
* `T-libs` handles the *implementation* of the standard libraries,
155+
as well as presentation and organization details of library docs, such as spelling and structure.
156+
* `T-libs-api` handles the *semantics* of standard libraries,
157+
such as type signatures, the addition of new functions,
158+
and what gurantees are and are not made by the documentation of functions
159+
(this includes error handling and platform-specific behavior).
160+
* `T-lang` handles the semantics of language features themselves, such as keywords.
161+
This includes the keyword docs in the standard library.
162+
* `T-spec` maintains [the reference](https://github.com/rust-lang/reference/).
163+
* `T-opsem` handles the operational semantics of the abstract machine,
164+
which defines what unsafe code is allowed to do without causing Undefined Behavior.
165+
This is covered in [the nomicon](https://doc.rust-lang.org/nomicon/),
166+
as well as some parts of library docs, such as in `core::ptr`.
167+
148168
### Creating labels
149169

150170
<div class="warning">

0 commit comments

Comments
 (0)