rust-lang · brson · Jan 14, 2016 · Sep 1, 2015 · Oct 13, 2015 · Oct 13, 2015
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,4 @@
 _site
 Gemfile.lock
 serve/
+*~
diff --git a/_config.yml b/_config.yml
@@ -1,2 +1,4 @@
 name: The Rust Programming Language
 markdown: redcarpet
+redcarpet:
+  extensions: ["tables"]
diff --git a/_layouts/basic.html b/_layouts/basic.html
@@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<!-- Page last generated {{ site.time }} -->
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>{{ page.title }}</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="keywords" content="Rust, Rust programming language, rustlang, rust-lang, Mozilla Rust">
+    <meta name="description" content="A systems programming language that runs blazingly fast, prevents segfaults, and guarantees thread safety.">
+
+    <link rel="stylesheet" href="/css/bootstrap.css">
+    <link rel="stylesheet" href="/css/style.css">
+  </head>
+
+  <body class="container">
+    <a href="https://github.com/rust-lang/rust">
+      <img class="ribbon" style="display: none" src="/logos/forkme.png" alt="Fork me on GitHub" width="298" height="298">
+    </a>
+
+    <header>
+
+    <ul class="row menu">
+      <li class="col-xs-12 col-md-2">
+        <a href="index.html">
+          <img class="img-responsive" src="logos/rust-logo-blk.svg" onerror="this.src='logos/rust-logo-256x256-blk.png'" height="128" width="128" alt="Rust logo" />
+        </a>
+      </li>
+      <li class="col-xs-12 col-md-10 menu">
+	<h2><a href="documentation.html">Documentation</a></h2>
+	<h2><a href="community.html">Community</a></h2>
+	<h2><a href="downloads.html">Downloads</a></h2>
+	<h2><a href="contribute.html">Contribute</a></h2>
+      </li>
+    </ul>
+  </header>
+    {{ content }}
+    <script>
+      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+      })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+      ga('create', 'UA-58390457-1', 'auto');
+      ga('send', 'pageview');
+
+    </script>
+  </body>
+</html>
diff --git a/_layouts/default.html b/_layouts/default.html
@@ -1,73 +1,7 @@
-<!DOCTYPE html>
-<!-- Page last generated {{ site.time }} -->
-<html lang="en">
-  <head>
-    <meta charset="utf-8">
-    <title>{{ page.title }}</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <meta name="keywords" content="Rust, Rust programming language, rustlang, rust-lang, Mozilla Rust">
-    <meta name="description" content="A systems programming language that runs blazingly fast, prevents segfaults, and guarantees thread safety.">
-    <link rel="stylesheet" href="/css/bootstrap.css">
-    <link rel="stylesheet" href="/css/style.css">
-  </head>
+---
+layout: basic
+---
 
-  <body class="container">
-    <a href="https://github.com/rust-lang/rust">
-      <img class="ribbon" style="display: none" src="/logos/forkme.png" alt="Fork me on GitHub" width="298" height="298">
-    </a>
-
-    <header>
-
-    <ul class="row menu">
-      <li class="col-xs-12 col-md-2">
-        <a href="index.html">
-          <img class="img-responsive" src="logos/rust-logo-blk.svg" onerror="this.src='logos/rust-logo-256x256-blk.png'" height="128" width="128" alt="Rust logo" />
-        </a>
-      </li>
-      <li class="col-xs-4 col-md-2"><h2>Docs (1.5.0)</h2>
-        <ul>
-          <li><a href="https://doc.rust-lang.org/stable/book/">Book</a></li>
-          <li><a href="https://doc.rust-lang.org/stable/reference.html">Reference</a></li>
-          <li>
-            <a href="https://doc.rust-lang.org/stable/std/">API docs</a></li>
-            <li><a href="https://doc.rust-lang.org/stable/">All docs</a>
-          </li>
-        </ul>
-      </li>
-      <li class="col-xs-4 col-md-2"><h2>Docs (Nightly)</h2>
-        <ul>
-          <li><a href="https://doc.rust-lang.org/nightly/book/">Book</a></li>
-          <li><a href="https://doc.rust-lang.org/nightly/reference.html">Reference</a></li>
-          <li>
-            <a href="https://doc.rust-lang.org/nightly/std/index.html">API docs</a></li>
-            <li><a href="https://doc.rust-lang.org/nightly/index.html">All docs</a>
-          </li>
-        </ul>
-      </li>
-      <li class="col-xs-4 col-md-2"><h2>Resources</h2>
-        <ul>
-	  <li>
-	    <a href="community.html">Community</a>
-	  </li>
-          <li>
-            <a href="legal.html">Legal</a>
-          </li>
-	  <li>
-	    <a href="security.html">Security</a>
-	  </li>
-        </ul>
-      </li>
-  </header>
-      {{ content }}
-    <script>
-      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-      })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-
-      ga('create', 'UA-58390457-1', 'auto');
-      ga('send', 'pageview');
-
-    </script>
-  </body>
-</html>
+<div class="content">
+  {{ content }}
+</div>
diff --git a/_layouts/faq.html b/_layouts/faq.html
@@ -0,0 +1,10 @@
+---
+layout: default
+---
+
+<link href='https://fonts.googleapis.com/css?family=Source+Serif+Pro:400,600' rel='stylesheet' type='text/css'>
+
+<div class="faq">
+  {{ content }}
+</div>
+
diff --git a/community.md b/community.md
@@ -1,9 +1,9 @@
 ---
 layout: default
-title: Rust Community &middot; The Rust Programming Language
+title: The Rust Community &middot; The Rust Programming Language
 ---
 
-# Rust Community
+# The Rust Community
 
 Rust is an amazing programming language, but its greatest strength
 is its kind and inclusive community.
@@ -129,6 +129,7 @@ socialize with other people with a similar interest. Meetings are
 usually held monthly and very informal. Meetings are open to everyone.
 
 There is a global [calendar][calendar] for keeping up with Rust events.
+Contact the [community team][community_team] to add your own.
 
 [user_group]: ./user_groups.html
 [calendar]: https://www.google.com/calendar/embed?src=apd9vmbc22egenmtu5l6c5jbfc@group.calendar.google.com
@@ -179,12 +180,11 @@ help get you started.
 [community_team]: https://www.rust-lang.org/team.html#Community
 [mod_team]: https://www.rust-lang.org/team.html#Moderation
 
+<a name="rust-development"></a>
 ## Rust Development
 
 Rust has had over [1,200 different contributors][authors], a number that grows
-every single week. We'd love for you to join that list! If you aren't sure what
-to work on or how to get started, take a look at our
-[how to contribute][contribute] page.
+every single week. [We'd love for you to join that list][contribute]!
 
 As mentioned above, the [Rust Internals Forum][internals_forum] is dedicated to
 discussing the design and implementation of Rust. A lot of discussion also
@@ -203,7 +203,7 @@ team business, including the progression of proposals through the RFC and
 implementation process.
 
 [authors]: https://github.com/rust-lang/rust/blob/master/AUTHORS.txt
-[contribute]: https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md
+[contribute]: contribute.html
 [github]: https://github.com/rust-lang/rust
 [rfcs]: https://github.com/rust-lang/rfcs
 [team_reports]: https://github.com/rust-lang/subteams

diff --git a/contribute-bugs.md b/contribute-bugs.md
@@ -0,0 +1,63 @@
+---
+layout: default
+title: Contributing to Rust &mdash; finding, triaging and fixing issues &middot; The Rust Programming Language
+---
+
+# Contributing to Rust &mdash; finding, triaging and fixing issues
+
+The day-to-day maintenance of the project revolves around Rust's
+[issue tracker] and [pull requests][PR], and more help is always
+needed. The most basic way to get started contributing to Rust is to
+look for the [E-easy] or [E-mentor] labels. These are meant to be
+approachable for new Rust programmers.
+
+On `E-mentor` issues an experienced Rust developer has volunteered in
+the comments to mentor you through solving the issue and [submitting
+the fix via GitHub pull request][pull]. Contact them about the issue,
+on the issue tracker by [@mentioning] their name in a comment, on IRC,
+or through email. Note that Rust developers get a lot of notifications
+and it is easy to miss some; don't hesitate to hunt them down by
+whatever means necessary!
+
+Other projects in Rust maintain similar entry-level tasks, including
+the web browser [Servo], the HTTP library [hyper], the
+source-formatter [rustfmt], and the lint collection [clippy].
+
+While Rust has an [extensive test suite][test] there is always more to
+test. The [E-needstest] label indicates issues that are thought to be
+fixed but don't have tests. Writing test cases is a great way to
+understand a new project and get started contributing.
+
+Rust is always in need of people to [triage] issues: reproduce bugs,
+minimize test cases, apply labels, close resolved issues. Note that
+you'll need elevated GitHub permissions to apply labels, but this is
+easy to obtain for somebody with a bit of experience in the
+project. Ask a [team member][team].
+
+Once you've found your way around the project and have created a few
+pull requests in a particular area, consider reviewing others' pull
+requests: good reviewership is a rare skill and always appreciated. No
+prior permission is needed &mdash; just start constructively and politely
+commenting on pull requests that interest you. If you want training
+on conducting good code reviews [read this guide][reviews].
+
+<!--
+TODO: weekly triage email?
+TODO: @nrc says suggesting everybody review w/o training is bad
+-->
+
+[@mentioning]: https://github.com/blog/821
+[E-easy]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy
+[E-mentor]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy+label%3AE-mentor
+[E-needstest]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-needstest
+[PR]: https://github.com/rust-lang/rust/pulls
+[Servo]: https://github.com/servo/servo
+[clippy]: https://github.com/Manishearth/rust-clippy
+[hyper]: https://github.com/hyperium/hyper
+[issue tracker]: https://github.com/rust-lang/rust/issues
+[pull]: https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md#pull-requests
+[reviews]: http://blog.originate.com/blog/2014/09/29/effective-code-reviews/
+[rustfmt]: https://github.com/nrc/rustfmt
+[team]: team.html
+[test]: https://github.com/rust-lang/rust-wiki-backup/blob/master/Note-testsuite.md
+[triage]: https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md#issue-triage
diff --git a/contribute-community.md b/contribute-community.md
@@ -0,0 +1,84 @@
+---
+layout: default
+title: Contributing to Rust &mdash; community building &middot; The Rust Programming Language
+---
+
+# Contributing to Rust &mdash; community building
+
+Help newbies, spread the word, meet interesting people. Make Rust the
+shining example of open source development that we all want it to be.
+
+Keep an eye on the [#rust-beginners] channel. This is where we direct
+new Rust programmers to ask for help, and it is vital when they do
+that they receive prompt, accurate, and courteous responses. Likewise,
+[Stack Overflow], [users.rust-lang.org], and [/r/rust], are all forums
+where Rust programers commonly look for assistance. If you want
+training on answering programmers' questions [read this
+guide][helpful].
+
+If you are already experienced in some area of the project, please
+look out for potential [E-easy] bugs. When you see an
+easy issue on the bug tracker that you know how to fix, write up a
+description of the fix and tag it with E-easy. Note that what is
+obvious to you is not obvious to a new Rust contributor, and its
+important to describe the problem and the solution clearly. It is
+thus also helpful to triage E-easy bugs for poor descrptions and
+improve them.
+
+Experienced developers who are patient and communicate clearly should
+consider [mentoring new contributors][mentor]. Tag easy issues with
+[E-mentor] and mention in a comment that you will mentor. Expect people
+to contact you about the issue, and attempt to respond promptly.
+
+Maintaining entry-level tasks is good not only for The Rust Project
+itself but all projects. If your project has a consistent supply of
+entry-level tasks you might institute such a program
+yourself. ***Curating entry-level tasks is one of the most effective
+methods of bringing new programmers into the project***. If you want
+training on mentoring new contributors [read this
+guide][mentor-guide].
+
+Talk about what you are working on in the weekly "what's everyone
+working on this week" threads on [/r/rust] and [users.rust-lang.org],
+and indicate what you need help with. These are great starting points
+for collaboration.
+
+Advocate Rust in your own local community. Rust [user groups] and [events]
+are a unique and exciting part of the Rust experience: there are so
+many, and they are everywhere! If you haven't been yet, go and enjoy
+new experiences. If there is nothing Rusty going on near you then
+consider organizing something. You can poll for interest and announce
+events on [/r/rust] or [users.rust-lang.org]. Contact the [community
+team] to put events on the calendar, and thus be announced on [This
+Week in Rust].
+
+Remember as you are advocating Rust though to be considerate of
+others' views &mdash; not everybody is going to be receptive to Rust, and
+that's just fine.
+
+Meet other Rust community builders in [#rust-community].
+
+<!--
+Other ideas:
+TWIR, podcasts.
+
+experience reports
+conf talks
+
+Conduct training on Rust. (link to training material).
+-->
+
+[#rust-beginners]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-beginners
+[#rust-community]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-community
+[/r/rust]: https://reddit.com/r/rust
+[E-easy]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy
+[E-mentor]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy+label%3AE-mentor
+[Stack Overflow]: http://stackoverflow.com/questions/tagged/rust
+[This Week in Rust]: http://www.this-week-in-rust.org
+[community team]: https://www.rust-lang.org/team.html#Community
+[events]: https://www.google.com/calendar/embed?src=apd9vmbc22egenmtu5l6c5jbfc@group.calendar.google.com
+[helpful]: http://blogs.msmvps.com/jonskeet/2009/02/17/answering-technical-questions-helpfully/
+[mentor]: https://users.rust-lang.org/t/mentoring-newcomers-to-the-rust-ecosystem/3088
+[mentor-guide]: http://manishearth.github.io/blog/2016/01/03/making-your-open-source-project-newcomer-friendly/
+[user groups]: user_groups.html
+[users.rust-lang.org]: https://users.rust-lang.org