Skip to content

Commit 345ab96

Browse files
Small improvements and clarifications
1 parent 85aebeb commit 345ab96

File tree

4 files changed

+14
-12
lines changed

4 files changed

+14
-12
lines changed

src/rustdoc/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ read about how the compiler and rustdoc work and instructions on how to set up a
77
you're looking for the [rustc-dev-guide](https://rustc-dev-guide.rust-lang.org/rustdoc.html).
88

99
- [Calendar](./calendar.md)
10-
- *How do I subscribe to the compiler team's calendar?*
10+
- *How do I subscribe to the rustdoc team's calendar?*
1111
- [Meetings](./meetings.md)
1212
- *What meetings do the rustdoc team run and how can I attend?*
1313
- [Membership](./membership.md)

src/rustdoc/meetings.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
# Meetings
22

3-
The rustdoc team hosts a meeting every second Monday on each month on the
4-
[t-rustdoc/meetings channel on zulip](https://rust-lang.zulipchat.com/#narrow/channel/393423-t-rustdoc.2Fmeetings)
5-
at 21:00 CET (UTC+1) and CEST on summer (UTC+2).
3+
You can check when the rustdoc team meetings are
4+
[here](https://github.com/rust-lang/calendar/blob/main/rustdoc.toml).
65

76
A new thread is open a month ahead of time to remind people who want to attend about the time
87
and the agenda.

src/rustdoc/membership.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Being promoted to member implies a number of privileges:
4646
It also implies some obligations (in some cases, optional obligations):
4747

4848
- Members are expected to respond to FCPs in maximum 4 weeks (28 days).
49-
- Members may take part in various other [maintainer activities] to help the team.
49+
- Members may take part in various other maintainer activities to help the team.
5050
- Members are held to a higher standard than ordinary folk when it comes to the [Code of
5151
Conduct][CoC].
5252

src/rustdoc/proposals-and-stabilization.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,20 +29,23 @@ the nature of the proposal, described below.
2929
proposal mechanism, reserved for significant changes.
3030
- RFC proposals can only be approved by *FCPs*.
3131
- Pull Request (PR)
32-
- PRs are pull requests to the [`rust-lang/rust`][rust] repository and are a light-weight
33-
proposal mechanism, suitable for most proposals. PRs are preferred when the proposal is
34-
accompanied by a small patchset (such as stabilization of a compiler flag or addition of
35-
a new target).
32+
- Opening a pull request on the [`rust-lang/rust`][rust] repository is a lightweight
33+
mechanism suitable for most proposals. This is preferred in cases such as stabilization
34+
of a rustdoc flag or addition of a new target.
3635
- PR proposals can be approved by *FCPs* or *r+*. See *When are FCPs/RFCs required?*
3736
section below when *r+* isn't sufficient alone.
37+
- Issues
38+
- Opening an issue on the [`rust-lang/rust`][rust] repository are also a good starting
39+
point if you don't know which of the previous ways is the best fit.
3840

3941
[rustdoc zulip thread]: https://rust-lang.zulipchat.com/#narrow/channel/266220-t-rustdoc
4042

4143
### When are FCPs/RFCs required?
4244

43-
An FCP will be needed for any stabilization of small user-facing changes, like UI/UX changes, new
44-
command-line arguments, new attributes, etc. However, if the change is considered too big/important,
45-
an RFC will need to be written and approved before the change will be accepted.
45+
An FCP will be needed for any stabilization of small user-facing changes, like UI/UX changes in
46+
the GUI web interface, new command-line arguments, new attributes, etc. However, if the change
47+
is considered too big/important, an RFC will need to be written and approved before the change
48+
will be accepted.
4649

4750
When starting an FCP, make sure only the relevant subteam is labeled on the issue/PR, to avoid
4851
pinging people with changes they aren't interested in.

0 commit comments

Comments
 (0)