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