|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: Contributing to Rust — community building · The Rust Programming Language |
| 4 | +--- |
| 5 | + |
| 6 | +# Contributing to Rust — community building |
| 7 | + |
| 8 | +Help newbies, spread the word, meet interesting people. Make Rust the |
| 9 | +shining example of open source development that we all want it to be. |
| 10 | + |
| 11 | +Keep an eye on the [#rust-beginners] channel. This is where we direct |
| 12 | +new Rust programmers to ask for help, and it is vital when they do |
| 13 | +that they receive prompt, accurate, and courteous responses. Likewise, |
| 14 | +[Stack Overflow], [users.rust-lang.org], and [/r/rust], are all forums |
| 15 | +where Rust programers commonly look for assistance. If you want |
| 16 | +training on answering programmers' questions [read this |
| 17 | +guide][helpful]. |
| 18 | + |
| 19 | +If you are already experienced in some area of the project, please |
| 20 | +look out for potential [E-easy] bugs. When you see an |
| 21 | +easy issue on the bug tracker that you know how to fix, write up a |
| 22 | +description of the fix and tag it with E-easy. Note that what is |
| 23 | +obvious to you is not obvious to a new Rust contributor, and its |
| 24 | +important to describe the problem and the solution clearly. It is |
| 25 | +thus also helpful to triage E-easy bugs for poor descrptions and |
| 26 | +improve them. |
| 27 | + |
| 28 | +Experienced developers who are patient and communicate clearly should |
| 29 | +consider [mentoring new contributors][mentor]. Tag easy issues with |
| 30 | +[E-mentor] and mention in a comment that you will mentor. Expect people |
| 31 | +to contact you about the issue, and attempt to respond promptly. |
| 32 | + |
| 33 | +Maintaining entry-level tasks is good not only for The Rust Project |
| 34 | +itself but all projects. If your project has a consistent supply of |
| 35 | +entry-level tasks you might institute such a program |
| 36 | +yourself. ***Curating entry-level tasks is one of the most effective |
| 37 | +methods of bringing new programmers into the project***. If you want |
| 38 | +training on mentoring new contributors [read this |
| 39 | +guide][mentor-guide]. |
| 40 | + |
| 41 | +Talk about what you are working on in the weekly "what's everyone |
| 42 | +working on this week" threads on [/r/rust] and [users.rust-lang.org], |
| 43 | +and indicate what you need help with. These are great starting points |
| 44 | +for collaboration. |
| 45 | + |
| 46 | +Advocate Rust in your own local community. Rust [user groups] and [events] |
| 47 | +are a unique and exciting part of the Rust experience: there are so |
| 48 | +many, and they are everywhere! If you haven't been yet, go and enjoy |
| 49 | +new experiences. If there is nothing Rusty going on near you then |
| 50 | +consider organizing something. You can poll for interest and announce |
| 51 | +events on [/r/rust] or [users.rust-lang.org]. Contact the [community |
| 52 | +team] to put events on the calendar, and thus be announced on [This |
| 53 | +Week in Rust]. |
| 54 | + |
| 55 | +Remember as you are advocating Rust though to be considerate of |
| 56 | +others' views — not everybody is going to be receptive to Rust, and |
| 57 | +that's just fine. |
| 58 | + |
| 59 | +Meet other Rust community builders in [#rust-community]. |
| 60 | + |
| 61 | +<!-- |
| 62 | +Other ideas: |
| 63 | +TWIR, podcasts. |
| 64 | +
|
| 65 | +experience reports |
| 66 | +conf talks |
| 67 | +
|
| 68 | +Conduct training on Rust. (link to training material). |
| 69 | +--> |
| 70 | + |
| 71 | +[#rust-beginners]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-beginners |
| 72 | +[#rust-community]: https://client00.chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-community |
| 73 | +[/r/rust]: https://reddit.com/r/rust |
| 74 | +[E-easy]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy |
| 75 | +[E-mentor]: https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy+label%3AE-mentor |
| 76 | +[Stack Overflow]: http://stackoverflow.com/questions/tagged/rust |
| 77 | +[This Week in Rust]: http://www.this-week-in-rust.org |
| 78 | +[community team]: https://www.rust-lang.org/team.html#Community |
| 79 | +[events]: https://www.google.com/calendar/[email protected] |
| 80 | +[helpful]: http://blogs.msmvps.com/jonskeet/2009/02/17/answering-technical-questions-helpfully/ |
| 81 | +[mentor]: https://users.rust-lang.org/t/mentoring-newcomers-to-the-rust-ecosystem/3088 |
| 82 | +[mentor-guide]: http://manishearth.github.io/blog/2016/01/03/making-your-open-source-project-newcomer-friendly/ |
| 83 | +[user groups]: user_groups.html |
| 84 | +[users.rust-lang.org]: https://users.rust-lang.org |
0 commit comments