|
1 |
| -# compiler-team |
| 1 | +# Static web page for Rust Compiler Team |
2 | 2 |
|
3 |
| -A home for compiler team planning documents, meeting minutes, and |
4 |
| -other such things. If you're interested in learning about how |
5 |
| -**rustc** works -- as well as advice on building the compiler, preparing a PR, |
6 |
| -and other similar topics -- check out the [rustc-guide]. |
| 3 | +This repository contains a static web page created with Hugo |
7 | 4 |
|
8 |
| -[rustc-guide]: https://rust-lang.github.io/rustc-guide/ |
| 5 | +Static Web Page for the Rust Compiler Team |
| 6 | +This repository contains a static web page created with [Hugo](https://gohugo.io/) using the [Book Theme](https://themes.gohugo.io/hugo-book/) |
9 | 7 |
|
10 |
| -## Quick facts |
| 8 | +## Getting Started |
11 | 9 |
|
12 |
| -- **Where to find us:** We are primarily present on [Zulip](about/chat-platform.md), though some of us also monitor Discord. |
13 |
| -- **Want to attend a meeting or follow along?** See the "meeting calendar" section below. |
14 |
| -- **Looking for technical information about how the compiler works?** |
15 |
| - Check out the [rustc-guide](https://rust-lang-nursery.github.io/rustc-guide/). |
| 10 | +In order to run this project you need to have already installed: |
16 | 11 |
|
17 |
| -## Meeting Calendar |
| 12 | +Hugo v0.55.6 |
18 | 13 |
|
19 |
| -Our meeting calendar is publicly available from the following links: |
| 14 | +## Run the website with the following commands: |
20 | 15 |
|
21 |
| - - [Web Link][embed] |
22 |
| - -- use this to view the calendar or to import into Google Calendar |
23 |
| - - [ICS file, for use outside from google calendar][ics] |
24 |
| - -- use this if you want to import into different calendar software |
| 16 | +Update the Hugo Theme: |
25 | 17 |
|
26 |
| -Unless otherwise noted, all our meetings are open to the public and |
27 |
| -held on Zulip. There are two main team-wide meetings that we hold on a |
28 |
| -regular basis. There are also a variety of working group meetings. |
| 18 | +``` |
| 19 | + git submodule update --init |
| 20 | +``` |
29 | 21 |
|
30 |
| -### Triage meeting |
| 22 | +Generate the web site: |
31 | 23 |
|
32 |
| -We have a [weekly triage meeting][triage] to discuss and track regressions and |
33 |
| -urgent changes. This meeting is held on Zulip and open to anyone. |
| 24 | +``` |
| 25 | + hugo -d dist --minify --theme book |
| 26 | +``` |
34 | 27 |
|
35 |
| -### Steering meeting |
36 |
| - |
37 |
| -We also have a [regular steering meeting][steering] where we discuss |
38 |
| -proposed designs, changes to our process, and other topics. The topics |
39 |
| -are scheduled at a planning meeting that occurs every four weeks. |
40 |
| - |
41 |
| -- **Have an idea?** Click here to propose a topic to be scheduled by [filing an issue][propose] with the correct template. |
42 |
| -- **Next planning meeting:** June 7 |
43 |
| -- **Scheduled meetings:** |
44 |
| - - June 14: [Discuss the gcx, tcx transition](https://calendar.google.com/event?action=TEMPLATE&tmeid=MnA4ZGk5cTVlODBpbm9jNGk3MTk1ZmZucGcgNnU1cnJ0Y2U2bHJ0djA3cGZpM2RhbWdqdXNAZw&tmsrc=6u5rrtce6lrtv07pfi3damgjus%40group.calendar.google.com), [compiler-team#104](https://github.com/rust-lang/compiler-team/issues/104) |
45 |
| - - June 28: [Maintenance and triage](https://calendar.google.com/event?action=TEMPLATE&tmeid=MnJhcnEzb3N2MWhzOTB0aDYxNWxoMDk1aTggNnU1cnJ0Y2U2bHJ0djA3cGZpM2RhbWdqdXNAZw&tmsrc=6u5rrtce6lrtv07pfi3damgjus%40group.calendar.google.com), [compiler-team#90](https://github.com/rust-lang/compiler-team/issues/90) |
46 |
| - |
47 |
| -[triage]: about/triage-meeting.md |
48 |
| -[steering]: about/steering-meeting.md |
49 |
| -[embed]: https://calendar.google.com/calendar/embed?src=6u5rrtce6lrtv07pfi3damgjus%40group.calendar.google.com |
50 |
| -[ics]: https://calendar.google.com/calendar/ical/6u5rrtce6lrtv07pfi3damgjus%40group.calendar.google.com/public/basic.ics |
51 |
| -[propose]: https://github.com/rust-lang/compiler-team/issues/new/choose |
52 |
| -## Working Groups |
53 |
| - |
54 |
| -Much of the ongoing work and initiatives from the compiler team are performed by working groups. |
55 |
| -Working groups are a great way for new contributors to get involved as they provide a stream of |
56 |
| -tasks all focused around one area and have designated channels for help and advice. All of the |
57 |
| -active working groups are listed below: |
58 |
| - |
59 |
| - |
60 |
| -Name | Status | Short Description | Zulip Stream |
61 |
| ----- | ------ | ----------------- | ------------ |
62 |
| -[Async-await Implementation](working-groups/async-await/) | Active | Implementing async-await | [#t-compiler/wg-async-await][async-await_stream] |
63 |
| -[LLVM](working-groups/llvm/) | Incubating | Working with LLVM upstream to represent Rust in its development | [#t-compiler/wg-llvm][llvm_stream] |
64 |
| -[Self-Profile](working-groups/self-profile/) | Active | Improving the `-Z self-profile` feature | [#t-compiler/wg-self-profile][self-profile_stream] |
65 |
| -[RFC 2229](working-groups/rfc-2229/) | Active | Make a closure capture individual fields of the variable rather than the entire composite variable | [#t-compiler/wg-rfc-2229][rfc-2229-stream] |
66 |
| -[RLS 2.0](working-groups/rls-2.0/) | Active | Experimenting with a new compiler architecture tailored for IDEs | [#t-compiler/wg-rls2.0][rls20_stream] |
67 |
| -[Meta](working-groups/meta/) | Active | How compiler team organizes itself | [#t-compiler/wg-meta][meta_stream] |
68 |
| -[Non-Lexical Lifetimes (NLL)](working-groups/nll/) | Winding down | Implementing non-lexical lifetimes | [#t-compiler/wg-nll][nll_stream] |
69 |
| -[Traits](working-groups/traits/) | Active | Improving the trait-system design + implementation | [#t-compiler/wg-traits][traits_stream] |
70 |
| -[Parallel-rustc](working-groups/parallel-rustc/) | Active | Making parallel compilation the default for rustc | [#t-compiler/wg-parallel-rustc][parallel-rustc_stream] |
71 |
| -[Profile-Guided Optimization](working-groups/pgo/) | Active | Implementing profile-guided optimization for rustc | [#t-compiler/wg-profile-guided-optimization][pgo_stream] |
72 |
| -[MIR Optimizations](working-groups/mir-opt/) | Active | Write MIR optimizations and refactor the MIR to be more optimizable. | [#t-compiler/wg-mir-opt][mir-opt-stream] |
73 |
| -[Rustc pipelining](working-groups/pipelining/) | Active | Enable Cargo to invoke rustc in a pipelined fashion, speeding up crate graph compiles. | [#t-compiler/wg-pipelining][pipelining-stream] |
74 |
| -[Polonius](working-groups/polonius/) | Active | Exploring the integration of the "NLL 2.0"-like ["Polonius analysis"][Polonius] into rustc | [#t-compiler/wg-polonius][polonius_stream] |
75 |
| -[Learning](working-groups/learning/) | Active | Make the compiler easier to learn by ensuring that rustc-guide and api docs are "complete" | [#t-compiler/wg-learning][learning_stream] |
76 |
| -[Diagnostics](working-groups/diagnostics/) | Active | Use crates.io crates for diagnostics rendering and make emitting diagnostics nicer. | [#t-compiler/wg-diagnostics][diagnostics-stream] |
77 |
| - |
78 |
| -[nikomatsakis]: https://github.com/nikomatsakis |
79 |
| -[cramertj]: https://github.com/cramertj |
80 |
| -[matklad]: https://github.com/matklad |
81 |
| -[pnkfelix]: https://github.com/pnkfelix |
82 |
| -[davidtwco]: https://github.com/davidtwco |
83 |
| -[spastorino]: https://github.com/spastorino |
84 |
| -[wesleywiser]: https://github.com/wesleywiser |
85 |
| -[michaelwoerister]: https://github.com/michaelwoerister |
86 |
| -[nagisa]: https://github.com/nagisa |
87 |
| -[Zoxc]: https://github.com/Zoxc |
88 |
| -[blitzerr]: https://github.com/blitzerr |
89 |
| -[oli-obk]: https://github.com/oli-obk |
90 |
| -[estebank]: https://github.com/estebank |
91 |
| - |
92 |
| -[Weekly, in Zulip]: #meeting-calendar |
93 |
| -[nll_stream]: https://rust-lang.zulipchat.com/#narrow/stream/122657-t-compiler.2Fwg-nll |
94 |
| -[llvm_stream]: https://rust-lang.zulipchat.com/#narrow/stream/187780-t-compiler.2Fwg-llvm |
95 |
| -[meta_stream]: https://rust-lang.zulipchat.com/#narrow/stream/185694-t-compiler.2Fwg-meta |
96 |
| -[rls20_stream]: https://rust-lang.zulipchat.com/#narrow/stream/185405-t-compiler.2Fwg-rls-2.2E0 |
97 |
| -[traits_stream]: https://rust-lang.zulipchat.com/#narrow/stream/144729-t-compiler.2Fwg-traits |
98 |
| -[async-await_stream]: https://rust-lang.zulipchat.com/#narrow/stream/187312-t-compiler.2Fwg-async-await |
99 |
| -[self-profile_stream]: https://rust-lang.zulipchat.com/#narrow/stream/187831-t-compiler.2Fwg-self-profile |
100 |
| -[pgo_stream]: https://rust-lang.zulipchat.com/#narrow/stream/187830-t-compiler.2Fwg-profile-guided-optimization |
101 |
| -[parallel-rustc_stream]: https://rust-lang.zulipchat.com/#narrow/stream/187679-t-compiler.2Fwg-parallel-rustc |
102 |
| -[rfc-2229-stream]: https://rust-lang.zulipchat.com/#narrow/stream/189812-t-compiler.2Fwg-rfc-2229 |
103 |
| -[mir-opt-stream]: https://rust-lang.zulipchat.com/#narrow/stream/189540-t-compiler.2Fwg-mir-opt |
104 |
| -[pipelining-stream]: https://rust-lang.zulipchat.com/#narrow/stream/195180-t-compiler.2Fwg-pipelining |
105 |
| -[polonius_stream]: https://rust-lang.zulipchat.com/#narrow/stream/186049-t-compiler.2Fwg-polonius |
106 |
| -[learning_stream]: https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-learning |
107 |
| -[Polonius]: https://github.com/rust-lang/polonius |
108 |
| -[diagnostics-stream]: https://rust-lang.zulipchat.com/#narrow/stream/147480-t-compiler.2Fwg-diagnostics |
109 |
| - |
110 |
| -## Expert Map |
111 |
| - |
112 |
| -If you're interested in figuring out who can answer questions about a |
113 |
| -particular part of the compiler, or you'd just like to know who works on what, |
114 |
| -check out our [experts directory](experts). It contains a listing of the |
115 |
| -various parts of the compiler and a list of people who are experts on each one. |
116 |
| - |
117 |
| -## Procedures |
118 |
| - |
119 |
| -The [procedures directory](procedures) contains descriptions of various |
120 |
| -rustc procedures. |
121 |
| - |
122 |
| -## Code of Conduct and licensing |
123 |
| - |
124 |
| -All interactions on this repository (whether on issues, PRs, or |
125 |
| -elsewhere) are governed by the [Rust Code of |
126 |
| -Conduct](CODE_OF_CONDUCT.md). |
127 |
| - |
128 |
| -Further, all content on this repository is subject to the standard |
129 |
| -[Rust](LICENSE-MIT) [licensing](LICENSE-APACHE). |
| 28 | +Run the web locally: |
| 29 | +``` |
| 30 | + hugo server --minify --theme book |
| 31 | +``` |
0 commit comments