rust/CONTRIBUTING.md
2015-01-27 15:44:05 -08:00

2.3 KiB

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.

Pull request procedure

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 your 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 style 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 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 example, if it's 2014, and you change a Rust file that was created in 2010, it should begin:

// Copyright 2010-2014 The Rust Project Developers.

Coordination and communication

Get feedback from other developers on internals.rust-lang.org, and #rust-internals.

For more details, please refer to Note-development-policy.