2013-10-21 14:10:57 -05:00
|
|
|
## How to submit a bug report
|
|
|
|
|
|
|
|
If you're just reporting a bug, please see:
|
|
|
|
|
2014-05-21 21:55:39 -05:00
|
|
|
http://doc.rust-lang.org/complement-bugreport.html
|
2013-10-21 14:10:57 -05:00
|
|
|
|
2012-12-27 16:58:45 -06:00
|
|
|
## Pull request procedure
|
|
|
|
|
2013-06-13 16:41:34 -05:00
|
|
|
Pull requests should be targeted at Rust's `master` branch.
|
2013-06-05 09:04:39 -05:00
|
|
|
Before pushing to your Github repo and issuing the pull request,
|
|
|
|
please do two things:
|
2012-12-27 16:58:45 -06:00
|
|
|
|
2013-06-05 09:04:39 -05:00
|
|
|
1. [Rebase](http://git-scm.com/book/en/Git-Branching-Rebasing) your
|
2013-06-13 16:41:34 -05:00
|
|
|
local changes against the `master` branch. Resolve any conflicts
|
2013-06-05 09:04:39 -05:00
|
|
|
that arise.
|
2012-12-27 16:58:45 -06:00
|
|
|
|
2013-06-05 09:04:39 -05: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
|
|
|
|
examples in the docs are tested as well!
|
2012-12-27 16:58:45 -06:00
|
|
|
|
2013-06-05 09:04:39 -05:00
|
|
|
Pull requests will be treated as "review requests", and we will give
|
|
|
|
feedback we expect to see corrected on
|
2014-06-16 18:07:34 -05:00
|
|
|
[style](https://github.com/rust-lang/rust/wiki/Note-style-guide) and
|
2013-06-05 09:04:39 -05: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-27 16:58:45 -06:00
|
|
|
|
2013-06-05 09:04:39 -05:00
|
|
|
Normally, all pull requests must include regression tests (see
|
2014-06-16 18:07:34 -05:00
|
|
|
[Note-testsuite](https://github.com/rust-lang/rust/wiki/Note-testsuite))
|
2013-06-05 09:04:39 -05: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-05 15:46:10 -05:00
|
|
|
example, if it's 2014, and you change a Rust file that was created in
|
2013-06-05 09:04:39 -05:00
|
|
|
2010, it should begin:
|
2013-01-29 13:07:02 -06:00
|
|
|
|
|
|
|
```
|
2014-05-05 15:46:10 -05:00
|
|
|
// Copyright 2010-2014 The Rust Project Developers.
|
2013-01-29 13:07:02 -06:00
|
|
|
```
|
|
|
|
|
2013-06-05 09:04:39 -05:00
|
|
|
For more details, please refer to
|
2014-06-16 18:07:34 -05:00
|
|
|
[Note-development-policy](https://github.com/rust-lang/rust/wiki/Note-development-policy).
|