2013-10-22 03:10:57 +08:00
|
|
|
## How to submit a bug report
|
|
|
|
|
|
|
|
|
|
If you're just reporting a bug, please see:
|
|
|
|
|
|
2014-05-22 10:55:39 +08:00
|
|
|
http://doc.rust-lang.org/complement-bugreport.html
|
2013-10-22 03:10:57 +08:00
|
|
|
|
2014-09-22 08:46:24 +08:00
|
|
|
## Submitting an issue
|
|
|
|
|
|
|
|
|
|
Please submit issues here for bug reports or implementation details. For feature
|
|
|
|
|
requests, language changes, or major changes to the libraries, please submit an
|
|
|
|
|
issue against the [RFCs repository](https://github.com/rust-lang/rfcs).
|
|
|
|
|
|
2012-12-28 06:58:45 +08:00
|
|
|
## Pull request procedure
|
|
|
|
|
|
2013-06-14 05:41:34 +08:00
|
|
|
Pull requests should be targeted at Rust's `master` branch.
|
2013-06-05 22:04:39 +08:00
|
|
|
Before pushing to your Github repo and issuing the pull request,
|
|
|
|
|
please do two things:
|
2012-12-28 06:58:45 +08:00
|
|
|
|
2013-06-05 22:04:39 +08:00
|
|
|
1. [Rebase](http://git-scm.com/book/en/Git-Branching-Rebasing) your
|
2013-06-14 05:41:34 +08:00
|
|
|
local changes against the `master` branch. Resolve any conflicts
|
2013-06-05 22:04:39 +08:00
|
|
|
that arise.
|
2012-12-28 06:58:45 +08:00
|
|
|
|
2013-06-05 22:04:39 +08:00
|
|
|
2. Run the full Rust test suite with the `make check` command. You're
|
|
|
|
|
not off the hook even if you just stick to documentation; code
|
2014-08-09 07:36:32 +08:00
|
|
|
examples in the docs are tested as well! Although for simple
|
|
|
|
|
wording or grammar fixes, this is probably unnecessary.
|
2012-12-28 06:58:45 +08:00
|
|
|
|
2013-06-05 22:04:39 +08:00
|
|
|
Pull requests will be treated as "review requests", and we will give
|
|
|
|
|
feedback we expect to see corrected on
|
2015-01-15 08:52:33 +08:00
|
|
|
[style](http://aturon.github.io/) and
|
2013-06-05 22:04:39 +08:00
|
|
|
substance before pulling. Changes contributed via pull request should
|
|
|
|
|
focus on a single issue at a time, like any other. We will not accept
|
|
|
|
|
pull-requests that try to "sneak" unrelated changes in.
|
2012-12-28 06:58:45 +08:00
|
|
|
|
2013-06-05 22:04:39 +08:00
|
|
|
Normally, all pull requests must include regression tests (see
|
2014-06-17 07:07:34 +08:00
|
|
|
[Note-testsuite](https://github.com/rust-lang/rust/wiki/Note-testsuite))
|
2013-06-05 22:04:39 +08:00
|
|
|
that test your change. Occasionally, a change will be very difficult
|
|
|
|
|
to test for. In those cases, please include a note in your commit
|
|
|
|
|
message explaining why.
|
|
|
|
|
|
|
|
|
|
In the licensing header at the beginning of any files you change,
|
|
|
|
|
please make sure the listed date range includes the current year. For
|
2014-05-06 04:46:10 +08:00
|
|
|
example, if it's 2014, and you change a Rust file that was created in
|
2013-06-05 22:04:39 +08:00
|
|
|
2010, it should begin:
|
2013-01-30 03:07:02 +08:00
|
|
|
|
|
|
|
|
```
|
2014-05-06 04:46:10 +08:00
|
|
|
// Copyright 2010-2014 The Rust Project Developers.
|
2013-01-30 03:07:02 +08:00
|
|
|
```
|
|
|
|
|
|
2015-01-03 07:41:47 +08:00
|
|
|
# Coordination and communication
|
|
|
|
|
|
|
|
|
|
Get feedback from other developers on
|
|
|
|
|
[discuss.rust-lang.org][discuss], and
|
|
|
|
|
[#rust-internals][pound-rust-internals].
|
|
|
|
|
|
|
|
|
|
[pound-rust-internals]: http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust-internals
|
|
|
|
|
[discuss]: http://discuss.rust-lang.org
|
|
|
|
|
|
2013-06-05 22:04:39 +08:00
|
|
|
For more details, please refer to
|
2014-06-17 07:07:34 +08:00
|
|
|
[Note-development-policy](https://github.com/rust-lang/rust/wiki/Note-development-policy).
|
