rewrite compiler team documentation

Author: davidtwco

book.toml

@@ -43,7 +43,16 @@ curly-quotes = true
 "x-py.html" = "https://rustc-dev-guide.rust-lang.org/building/how-to-build-and-run.html"
 "compiler/bug-fix-procedure.html" = "https://rustc-dev-guide.rust-lang.org/bug-fix-procedure.html"
 "compiler/diagnostic-codes.html" = "https://rustc-dev-guide.rust-lang.org/diagnostics/diagnostic-codes.html"
+"compiler/mcp.html" = "https://rustc-dev-guide.rust-lang.org/compiler/proposals-and-stabilization.html"
+"compiler/new_option.html" = "https://rustc-dev-guide.rust-lang.org/compiler/proposals-and-stabilization.html"
+"compiler/prioritization/priority-levels.html" = "https://rustc-dev-guide.rust-lang.org/compiler/prioritization.html"
+"compiler/prioritization/procedure.html" = "https://rustc-dev-guide.rust-lang.org/compiler/prioritization.html"
 "compiler/profile-queries.html" = "https://rustc-dev-guide.rust-lang.org/queries/profiling.html"
+"compiler/steering-meeting.html" = "https://rustc-dev-guide.rust-lang.org/compiler/meetings.html"
+"compiler/steering-meeting/how-to-run-design.html" = "https://rustc-dev-guide.rust-lang.org/compiler/meetings.html"
+"compiler/steering-meeting/how-to-run-planning.html" = "https://rustc-dev-guide.rust-lang.org/compiler/meetings.html"
+"compiler/steering-meeting/submit.html" = "https://rustc-dev-guide.rust-lang.org/compiler/meetings.html"
+"compiler/triage-meeting.html" = "https://rustc-dev-guide.rust-lang.org/compiler/meetings.html"
 "chat/index.html" = "/platforms/index.html"
 "chat/discord.html" = "/platforms/discord.html"
 "github.html" = "/platforms/github.html"

src/SUMMARY.md

@@ -42,22 +42,16 @@
     - [GitHub Actions created PR open/closer](./triagebot/bot-pull-requests.md)
 - [Community](./community/README.md)
 - [Compiler](./compiler/README.md)
-    - [Cross Compilation](./compiler/cross-compilation/README.md)
-        - [Windows](./compiler/cross-compilation/windows.md)
+    - [Calendar](./compiler/calendar.md)
     - [Cross-team Collaboration](./compiler/cross-team-collaboration.md)
-    - [Review policy](./compiler/reviews.md)
-    - [So you want to add a new option to rustc?](./compiler/new_option.md)
-    - [Major Change Proposals](./compiler/mcp.md)
+    - [Meetings](./compiler/meetings.md)
     - [Membership](./compiler/membership.md)
-    - [Prioritization](./compiler/prioritization.md)
-      - [Procedure](./compiler/prioritization/procedure.md)
-      - [Priority Levels](./compiler/prioritization/priority-levels.md)
     - [Notification groups](./compiler/notification-groups.md)
-    - [Triage Meeting](./compiler/triage-meeting.md)
-    - [Steering Meeting](./compiler/steering-meeting.md)
-        - [Submitting a proposal](./compiler/steering-meeting/submit.md)
-        - [How to run the planning meeting](./compiler/steering-meeting/how-to-run-planning.md)
-        - [How to run a design meeting](./compiler/steering-meeting/how-to-run-design.md)
+    - [Resources](./compiler/resources.md)
+    - [Review Policy](./compiler/reviews.md)
+    - [Proposals, Approval and Stabilization](./compiler/proposals-and-stabilization.md)
+    - [Third-party and Out-of-tree Crates Policy](./compiler/third-party-out-of-tree.md)
+    - [Triage and Prioritization](./compiler/prioritization.md)
 - [crates.io](./crates-io/README.md)
     - [Crate removal](./crates-io/crate-removal.md)
     - [Database maintenance](./crates-io/db-maintenance.md)

src/compiler/README.md

@@ -1,17 +1,27 @@
 # Compiler
-This section documents the Rust compiler itself, its APIs, and how to
-contribute and provide bug fixes for the compiler.
+Rust's compiler team are responsible for maintaining the Rust compiler, improving its performance
+and considering the stabilization of compiler features.
 
-### External Links
-* The [Rustc Dev Guide] documents how the compiler works as well providing helpful
-  information to help get new contributors involved in the development.
-* Rustc's [internal documentation].
-* The [Compiler team] website is the home for all of the compiler
-  team's planning.
-* oli-obk's [FIXME page] lists all of the `FIXME` comments in the Rust compiler.
+We use the Forge to document the team's processes, policies and working practices, if you'd like to
+read about how the compiler works and instructions on how to set up a development environment,
+you're looking for the [rustc-dev-guide](https://rustc-dev-guide.rust-lang.org/).
 
-
-[Compiler team]: https://rust-lang.github.io/compiler-team/
-[FIXME page]: https://oli-obk.github.io/fixmeh/
-[Rustc Dev Guide]: https://rustc-dev-guide.rust-lang.org/
-[internal documentation]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_middle/
+- [Calendar](./calendar.md)
+  - *How do I subscribe to the compiler team's calendar?*
+- [Cross-team Collaboration](./cross-team-collaboration.md)
+  - *How do I request the help of the compiler team?*
+- [Meetings](./meetings.md)
+  - *What meetings do the compiler team run and how can I attend?*
+- [Membership](./membership.md)
+  - *What is expected of compiler team members and how do I join?*
+- [Resources](./resources.md)
+  - *What useful resources are available for contributors and team members?*
+- [Review Policy](./reviews.md)
+  - *How do I make a contribution which is easy to review? How do I start reviewing as a team member?*
+- [Proposals, Approval and Stabilization](./proposals-and-stabilization.md)
+  - *How do I propose a change to the compiler team? What approval is necessary for my change?*
+- [Third-party and Out-of-tree Crates Policy](./third-party-out-of-tree.md)
+  - *When can I add third-party crates to the compiler? When can I create a out-of-tree crate for
+     the compiler?*
+- [Triage and Prioritization](./prioritization.md)
+  - *How are compiler issues triaged and prioritized?*

src/compiler/calendar.md

@@ -0,0 +1,39 @@
+# Calendar
+All of the compiler team's calendars are available in the Rust project's
+[`rust-lang/calendar`][calendar_repo] repository.
+
+## Adding new events
+Any project member can submit a pull request to [add new events][add_event] or
+[subcalendars][add_calendar], just assign the compiler team's leads as a reviewer for the pull
+request.
+
+## Subscribing to the calendar
+The team's calendar is [distributed as an `ics` file][ics] that can be imported into your preferred
+calendar application.
+
+> You can copy the calendar link from below:
+>
+> `https://rust-lang.github.io/calendar/compiler.ics`
+>
+> Alternative links which do not include working groups are available on the
+> [calendar repository][calendar_repo].
+
+- Fastmail
+  - Open the Settings page. Go to "Calendars" on the left sidebar. Scroll down to the
+    "Subscriptions" section and paste the link to the [compiler team calendar][ics] into the
+    field and press "Subscribe to calendar".
+- Google Calendar
+  - Press the "+" icon next to "Other Calendars" in the left sidebar. Select "From URL" and paste
+    the link to the [compiler team calendar][ics] into the field and press "Add calendar".
+- Outlook Web
+  - Go to the Calendar using the icon on the left sidebar. Select "Add Calendar" on the left and
+    then "Subscribe from the web", paste the link to the [compiler team calendar][ics] into the
+    field and press "Import".
+
+If your preferred calendar application isn't listed above, feel free to submit a pull request to
+this documentation to add instructions above.
+
+[add_calendar]: https://github.com/rust-lang/calendar?tab=readme-ov-file#how-do-i-add-a-calendar
+[add_event]: https://github.com/rust-lang/calendar?tab=readme-ov-file#how-do-i-add-an-event
+[calendar_repo]: https://github.com/rust-lang/calendar
+[ics]: https://rust-lang.github.io/calendar/compiler.ics