|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: Community |
| 4 | +--- |
| 5 | + |
| 6 | +# Rust Community |
| 7 | + |
| 8 | +Rust is an amazing programming language, but its greatest strength |
| 9 | +is its kind and inclusive community. |
| 10 | + |
| 11 | +We are committed to providing a friendly, safe and welcoming |
| 12 | +environment for all, regardless of gender, sexual orientation, |
| 13 | +disability, ethnicity, religion, or similar personal |
| 14 | +characteristic. Our [code of conduct][coc] sets the standards for |
| 15 | +behavior in all official Rust forums, and is upheld by the |
| 16 | +[moderation team][mod_team_email]. |
| 17 | + |
| 18 | +[coc]: https://www.rust-lang.org/conduct.html |
| 19 | + |
| 20 | +## TL;DR |
| 21 | + |
| 22 | +The most important community resources for getting started with Rust are: |
| 23 | + |
| 24 | +- The [#rust-beginners][beginners_irc] IRC channel, a very friendly channel that |
| 25 | + loves answering questions at any depth. |
| 26 | +- The [users forum][users_forum] for asynchronous discussion about all |
| 27 | + things Rust. |
| 28 | +- The [This Week in Rust][twir] newsletter, to keep up with what's |
| 29 | + happening in the community. |
| 30 | + |
| 31 | +## News |
| 32 | + |
| 33 | +[This Week in Rust][twir] collects the latest news, upcoming events |
| 34 | +and a week-by-week account of changes in the Rust language and |
| 35 | +libraries. |
| 36 | + |
| 37 | +[The Rust Blog][rust_blog] is where the Rust team makes announcements |
| 38 | +about major developments. |
| 39 | + |
| 40 | +The Rust community has an [*unofficial* subreddit][reddit] where |
| 41 | +virtually everything happening in the Rust community is discussed. |
| 42 | +The forum abides by the [official code of conduct][reddit_coc]. |
| 43 | + |
| 44 | +We also have an official [Twitter][twitter] account. |
| 45 | + |
| 46 | +[twir]: http://this-week-in-rust.org/ |
| 47 | +[rust_blog]: http://blog.rust-lang.org/ |
| 48 | +[reddit]: https://www.reddit.com/r/rust |
| 49 | +[reddit_coc]: https://www.reddit.com/r/rust/comments/2rvrzx/our_code_of_conduct_please_read/ |
| 50 | +[twitter]: https://twitter.com/rustlang |
| 51 | + |
| 52 | +## How to Get Help |
| 53 | + |
| 54 | +### Moderation |
| 55 | + |
| 56 | +[Rust Moderation Team][mod_team] |
| 57 | + |
| 58 | +If you feel you have been or are being harassed or made uncomfortable |
| 59 | +by a community member, please [contact][mod_team_email] any of the |
| 60 | +Rust moderation team immediately. Whether you're a regular contributor |
| 61 | +or a newcomer, we care about making the community a safe space for |
| 62 | +you. |
| 63 | + |
| 64 | +[mod_team]: https://www.rust-lang.org/team.html#Moderation |
| 65 | +[mod_team_email]: mailto:[email protected] |
| 66 | + |
| 67 | +### IRC Channels |
| 68 | + |
| 69 | +Rustaceans maintain a number of friendly, high-traffic IRC channels. |
| 70 | + |
| 71 | +The [#rust][rust_irc] channel on Moznet is a venue for general |
| 72 | +discussion about Rust, and a good place to ask for help. You'll find |
| 73 | +people willing to help you with any questions you may have, and |
| 74 | +responses are typically very fast. |
| 75 | + |
| 76 | +To get involved in the development of Rust itself, for anything about |
| 77 | +contribution, or to find a mentor, [#rust-internals][internals_irc] is |
| 78 | +the right channel. |
| 79 | + |
| 80 | +There are also some more specific IRC channels |
| 81 | +noted below. |
| 82 | + |
| 83 | +#### Core channels |
| 84 | + |
| 85 | +- [#rust][rust_irc] is for all things Rust |
| 86 | +- [#rust-internals][internals_irc] is for discussion of other Rust implementation topics |
| 87 | +- [#rustc][rustc_irc] is the home of the [compiler team][compiler_team] |
| 88 | +- [#rust-libs][libs_irc] is the home of the [libraries team][library_team] |
| 89 | +- [#rust-tools][tools_irc] is the home of the [tools and infrastructure team][tool_team] |
| 90 | +- [#rust-lang][lang_irc] is the home of the [language team][language_team] |
| 91 | +- [#rust-community][community_irc] is the home of the [community team][community_team] |
| 92 | + |
| 93 | +#### Topical channels |
| 94 | + |
| 95 | +- [#rust-beginners][beginners_irc] is a space for those new to Rust, lower traffic than #rust |
| 96 | +- [#cargo][cargo_irc] is for discussion of Cargo, Rust's package manager |
| 97 | +- [#servo][servo_irc] is for discussion of Servo, the browser engine written in Rust |
| 98 | +- [#rust-offtopic][offtopic_irc] is for general chit-chat amongst Rustaceans |
| 99 | +- [#rust-crypto][crypto_irc] is for discussion of cryptography in Rust |
| 100 | +- [#rust-osdev][osdev_irc] is for people doing OS development in Rust |
| 101 | +- [#rust-webdev][webdev_irc] is for people doing web development in Rust |
| 102 | +- [#rust-gamedev][gamedev_irc] is for people doing game development in Rust |
| 103 | +- [#rust-bots][bots_irc] notifcations about Rust from a selection of bots |
| 104 | + |
| 105 | +[rust_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust |
| 106 | +[rustc_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rustc |
| 107 | +[libs_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-libs |
| 108 | +[tools_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-tools |
| 109 | +[lang_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-lang |
| 110 | +[community_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-community |
| 111 | +[internals_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-internals |
| 112 | +[gamedev_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-gamedev |
| 113 | +[crypto_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-crypto |
| 114 | +[osdev_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-osdev |
| 115 | +[webdev_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-webdev |
| 116 | +[cargo_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23cargo |
| 117 | +[offtopic_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-offtopic |
| 118 | +[servo_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23servo |
| 119 | +[bots_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-bots |
| 120 | +[beginners_irc]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-beginners |
| 121 | + |
| 122 | +### Discussion Forums |
| 123 | + |
| 124 | +We have two forums for asynchronous discussion: |
| 125 | + |
| 126 | +- The [Users Forum][users_forum], a space for asking questions, posting code |
| 127 | + snippets, talking about Rust projects, and so on. |
| 128 | + |
| 129 | +- The [Internals Forum][internals_forum], a space dedicated to design and |
| 130 | + implementation discussion about Rust itself (which includes Cargo, the |
| 131 | + standard library, and other core bits of infrastructure). |
| 132 | + |
| 133 | +[users_forum]: https://users.rust-lang.org/ |
| 134 | +[internals_forum]: https://internals.rust-lang.org/ |
| 135 | + |
| 136 | +### Stack Overflow |
| 137 | + |
| 138 | +[Stack Overflow][stack_overflow] is a question and answer site for programmers. |
| 139 | +The Rust community is fairly active on the site, so searching for your problem |
| 140 | +might reveal someone who has asked it before. |
| 141 | + |
| 142 | +[stack_overflow]: https://stackoverflow.com/questions/tagged/rust |
| 143 | + |
| 144 | +## User Groups and Meetups |
| 145 | + |
| 146 | +There are more than 50 [Rust User Groups][user_group] worldwide in over 20 |
| 147 | +countries totaling over 7,000 members. Rustaceans meet periodically in Rust User |
| 148 | +Groups. Its a great introduction to the community and a great way to learn and |
| 149 | +socialize with other people with a similar interest. Meetings are |
| 150 | +usually held monthly and very informal. Meetings are open to everyone. |
| 151 | + |
| 152 | +There's a global [calendar][calendar] for keeping up with Rust events. |
| 153 | + |
| 154 | +[user_group]: ./user_groups.html |
| 155 | +[calendar]: https://www.google.com/calendar/[email protected] |
| 156 | + |
| 157 | +## The Teams |
| 158 | + |
| 159 | +Rust has a community-driven development process where most decisions are made |
| 160 | +through open discussion and consensus, under the stewardship of various |
| 161 | +[teams][teams]: |
| 162 | + |
| 163 | +* The [Core Team][core_team] is responsible for steering the design and |
| 164 | +development process, overseeing the introduction of new features, and ultimately |
| 165 | +making decisions for which there is no consensus (this happens rarely). |
| 166 | + |
| 167 | +* The [Language Design Team][language_team] is responsible for the |
| 168 | + design of new language features. |
| 169 | + |
| 170 | +* The [Library Team][library_team] is responsible for the Rust standard |
| 171 | +library, rust-lang crates, and conventions. |
| 172 | + |
| 173 | +* The [Compiler Team][compiler_team] is responsible for compiler internals and |
| 174 | +optimizations. |
| 175 | + |
| 176 | +* The [Tooling and Infrastructure Team][tool_team] is responsible for official |
| 177 | +tools like Cargo, multirust, rustfmt, as well as the CI Infrastructure for the |
| 178 | +project. |
| 179 | + |
| 180 | +* The [Community Team][community_team] is responsible for coordinating events, |
| 181 | +outreach, commercial users, teaching materials, and exposure. They can also |
| 182 | +direct inquiries to the correct parties when its not clear who to contact |
| 183 | +about something Rusty. |
| 184 | + |
| 185 | +* The [Moderation Team][mod_team] is responsible for helping to uphold the |
| 186 | +[code of conduct][coc]. |
| 187 | + |
| 188 | +In addition to the official team rosters, most teams also have a larger set |
| 189 | +of reviewers who are knowledgeable about the area and can sign off on |
| 190 | +code. If you're interested in getting involved in one of these teams, |
| 191 | +feel free to reach out to the team leader or any other member, who can |
| 192 | +help get you started. |
| 193 | + |
| 194 | +If you are not sure where to direct an enquiry, the best starting point |
| 195 | +would be the [community team][community_team]. |
| 196 | + |
| 197 | +[teams]: https://www.rust-lang.org/team.html |
| 198 | +[core_team]: https://www.rust-lang.org/team.html#Core |
| 199 | +[language_team]: https://www.rust-lang.org/team.html#Language-design |
| 200 | +[library_team]: https://www.rust-lang.org/team.html#Library |
| 201 | +[compiler_team]: https://www.rust-lang.org/team.html#Compiler |
| 202 | +[tool_team]: https://www.rust-lang.org/team.html#Tooling-and-infrastructure |
| 203 | +[community_team]: https://www.rust-lang.org/team.html#Community |
| 204 | +[mod_team]: https://www.rust-lang.org/team.html#Moderation |
| 205 | + |
| 206 | +## Rust Development |
| 207 | + |
| 208 | +Rust has had over [1,200 different contributors][authors], a number that grows |
| 209 | +every single week. We'd love for you to join that list! If you aren't sure what |
| 210 | +to work on or how to get started, take a look at our |
| 211 | +[how to contribute][contribute] page. |
| 212 | + |
| 213 | +As mentioned above, the [Rust Internals Forum][internals_forum] is dedicated to |
| 214 | +discussing the design and implementation of Rust. A lot of discussion also |
| 215 | +happens on Github: |
| 216 | + |
| 217 | +- The [main repository][github] and [issue tracker][issue_tracking] are the |
| 218 | + front lines of the implementation work. Our reviewers strive to be friendly |
| 219 | + and to help mentor newcomers, so don't hesitate to open a pull request! |
| 220 | + |
| 221 | +- The [RFC repo][rfcs] tracks our Request for Comment process, the main pathway |
| 222 | + through which the Rust community and the teams reach consensus on new |
| 223 | + features proposed for the language and official libraries and tools. |
| 224 | + |
| 225 | +Roughly weekly, the Rust teams produce [team reports][team_reports] tracking |
| 226 | +team business, including the progression of proposals through the RFC and |
| 227 | +implementation process. |
| 228 | + |
| 229 | +[authors]: https://github.com/rust-lang/rust/blob/master/AUTHORS.txt |
| 230 | +[contribute]: https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md |
| 231 | +[github]: https://github.com/rust-lang/rust |
| 232 | +[rfcs]: https://github.com/rust-lang/rfcs |
| 233 | +[team_reports]: https://github.com/rust-lang/subteams |
| 234 | +[issue_tracking]: https://github.com/rust-lang/rust/issues |
0 commit comments