Skip to content

Commit 74de9db

Browse files
authored
Rollup merge of rust-lang#82887 - henryboisdequin:improve-contributing-md, r=joshtriplett
Update CONTRIBUTING.md Fixes rust-lang#77215 As mentioned in rust-lang#77215, the current CONTRIBUTING.md links to the rustc-dev-guide. Even though the rustc-dev-guide has lots of useful information for contributors, one is already confused by reading the first line of the current CONTRIBUTING.md. > To get started, read the [Getting Started] guide in the [rustc-dev-guide]. This line tells the contributor to go and read the rustc-dev-guide. What is the rustc-dev-guide? What does rustc even mean? These are some of the questions that went into my head when reading this line as a first-time contributor. By explaining what the rustc-dev-guide is and some platforms to get help, a new contributor understands what the first step is and the process is much clearer. The `About the [rustc-dev-guide]` section explains what the rustc-dev-guide is, what rustc is, and the purpose out of reading the guide. The `Getting help` section points the user to some places where they can get help, find a mentor, and introduce themselves.
2 parents bf15802 + bf40ac6 commit 74de9db

File tree

1 file changed

+28
-2
lines changed

1 file changed

+28
-2
lines changed

CONTRIBUTING.md

+28-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,31 @@
11
# Contributing to Rust
22

3-
Thank you for your interest in contributing to Rust!
3+
Thank you for your interest in contributing to Rust! There are many ways to contribute
4+
and we appreciate all of them.
45

5-
To get started, read the [Contributing to Rust] chapter of the [rustc-dev-guide].
6+
Documentation for contributing to Rust is located in the [Guide to Rustc Development](https://rustc-dev-guide.rust-lang.org/),
7+
commonly known as the [rustc-dev-guide]. Despite the name, this guide documents
8+
not just how to develop rustc (the Rust compiler), but also how to contribute to any part
9+
of the Rust project.
10+
11+
To get started with contributing, please read the [Contributing to Rust] chapter of the guide.
12+
That chapter explains how to get your development environment set up and how to get help.
13+
14+
## About the [rustc-dev-guide]
15+
16+
The [rustc-dev-guide] is meant to help document how rustc –the Rust compiler– works,
17+
as well as to help new contributors get involved in rustc development. It is recommend
18+
to read and understand the [rustc-dev-guide] before making a contribution. This guide
19+
talks about the different bots in the Rust ecosystem, the Rust development tools,
20+
bootstrapping, the compiler architecture, source code representation, and more.
21+
22+
## [Getting help](https://rustc-dev-guide.rust-lang.org/getting-started.html#asking-questions)
23+
24+
There are many ways you can get help when you're stuck. Rust has many platforms for this:
25+
[internals], [rust-zulip], and [rust-discord]. It is recommended to ask for help on
26+
the [rust-zulip], but any of these platforms are a great way to seek help and even
27+
find a mentor! You can learn more about asking questions and getting help in the
28+
[Asking Questions](https://rustc-dev-guide.rust-lang.org/getting-started.html#asking-questions) chapter of the [rustc-dev-guide].
629

730
## Bug reports
831

@@ -13,3 +36,6 @@ refer to [this section][contributing-bug-reports] and [open an issue][issue temp
1336
[rustc-dev-guide]: https://rustc-dev-guide.rust-lang.org/
1437
[contributing-bug-reports]: https://rustc-dev-guide.rust-lang.org/contributing.html#bug-reports
1538
[issue template]: https://github.com/rust-lang/rust/issues/new/choose
39+
[internals]: https://internals.rust-lang.org
40+
[rust-discord]: http://discord.gg/rust-lang
41+
[rust-zulip]: https://rust-lang.zulipchat.com

0 commit comments

Comments
 (0)