Skip to content

Commit f9e0638

Browse files
committed
Team Roles -> Team Examples
Make things sound less authoritive.
1 parent 8968f78 commit f9e0638

File tree

1 file changed

+29
-20
lines changed

1 file changed

+29
-20
lines changed

src/release/issue-triaging.md

Lines changed: 29 additions & 20 deletions
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`. See [Team Roles](#team-roles) for more details.
83+
- [`T-*`]: Specifies the team or teams that this issue is relevant to. For example `T-compiler`, `T-types` or `T-libs`. See [Team Examples](#team-examples) 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,25 +145,34 @@ 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`.
148+
#### Team Examples
149+
This section gives a list of examples of kinds of issues that should be assigned to a specific team.
150+
151+
##### T-compiler
152+
Anything related to the compiler implementation, such as diagnostics and ICEs.
153+
154+
##### T-libs
155+
* Changes to implementation details of library functions
156+
* Spelling, grammar, and organizational changes in library docs
157+
158+
##### T-libs-api
159+
* New library functions
160+
* Changes to signatures of unstable functions
161+
* Semantic changes to library documentation,
162+
such as guranteeing that a function will produce a certain error code in some situation
163+
164+
##### T-lang
165+
* New keywords/language features
166+
* Changes to the keyword docs in the standard library
167+
168+
##### T-spec
169+
* Changes to [the reference](https://github.com/rust-lang/reference/)
170+
171+
##### T-opsem
172+
* Changes to [the nomicon](https://doc.rust-lang.org/nomicon/)
173+
* Changes to the semantics of the abstract machine, such as the sematics of atomics.
174+
* Changes to the docs of unsafe pointer functions
175+
* Changes to the docs of `core::ptr`
167176

168177
### Creating labels
169178

0 commit comments

Comments
 (0)