rust/CONTRIBUTING.md

52 lines
2 KiB
Markdown
Raw Normal View History

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