Merge pull request #70 from spastorino/learning-wg

Add Learning WG

Author: nikomatsakis

README.md

@@ -60,6 +60,7 @@ Name                                                      | Status       | Short
 [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]
 [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]
 [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]
+[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]
 
 [nikomatsakis]: https://github.com/nikomatsakis
 [cramertj]: https://github.com/cramertj
@@ -88,6 +89,7 @@ Name                                                      | Status       | Short
 [mir-opt-stream]: https://rust-lang.zulipchat.com/#narrow/stream/189540-t-compiler.2Fwg-mir-opt
 [pipelining-stream]: https://rust-lang.zulipchat.com/#narrow/stream/195180-t-compiler.2Fwg-pipelining
 [polonius_stream]: https://rust-lang.zulipchat.com/#narrow/stream/186049-t-compiler.2Fwg-polonius
+[learning_stream]: https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-learning
 [Polonius]: https://github.com/rust-lang/polonius
 
 ## Expert Map

working-groups/learning/FAQ.md

@@ -0,0 +1,5 @@
+# Frequently Asked Questions (FAQ)
+
+If you have a question, feel free to file an issue or ask in the working group's Zulip stream.
+
+There are no FAQs so far. Please ask us more questions.

working-groups/learning/NOTES.md

@@ -0,0 +1,3 @@
+# Learning Meeting Notes
+
+This document will contain meeting notes from the learning working group.

working-groups/learning/README.md

@@ -0,0 +1,36 @@
+# Learning Working Group
+![working group status: active][status]
+
+This working group aims to make the compiler easier to learn by ensuring that rustc-guide and api docs are "complete".
+
+- **Leads:** [@nikomatsakis][nikomatsakis] and [@spastorino][spastorino]
+- **[Ideas][ideas]**
+- **Meeting Notes:** [All](NOTES.md)
+
+[status]: https://img.shields.io/badge/status-active-brightgreen.svg?style=for-the-badge
+[nikomatsakis]: https://github.com/nikomatsakis
+[spastorino]: https://github.com/spastorino
+[ideas]: https://paper.dropbox.com/doc/Learning-Working-Group-Ideas--Ab18Mvvg7fYl8b~WL_klryqnAg-2R49k1GWZFojHIQ5x1fuB
+
+## What is the goal of this working group?
+This working group aims to accomplish the following:
+
+- Ensure that major components of rustc are covered in rustc-guide
+- Ensure that API doc coverage is at least 90%
+
+# How can I get involved?
+If you are interested in getting involved in this working group, come and say hi in the Zulip
+stream. You can be added to the Zulip group for the working group if you are interested in being
+pinged when there are available tasks.
+
+## Meetings
+We follow a "sprint-like" structure where on each "sprint" cycle we start with a planning and then
+work towards the goals defined on that plan.
+
+- **Desired experience level:** Any
+- **Relevant repositories:** [`rust-lang/rust`][rust-repo] and [rust-lang/rustc-guide][rustc-guide-repo]
+- **Zulip stream:** [`#t-compiler/wg-learning`][zulip] on Zulip
+
+[rust-repo]: https://github.com/rust-lang/rust
+[rustc-guide-repo]: https://github.com/rust-lang/rustc-guide
+[zulip]: https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-learning