Add CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644 (file)
index 0000000..cc37791
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,39 @@
+# Contributing to Cargo
+
+Thank you for your interest in contributing to Cargo! Good places to
+start are this document, [ARCHITECTURE.md](ARCHITECTURE.md), which
+describes high-level structure of Cargo and [E-easy] bugs on the
+issue tracker.
+
+As a reminder, all contributors are expected to follow our [Code of Conduct].
+
+[E-easy]: https://github.com/rust-lang/cargo/labels/E-easy
+[Code of Conduct]: https://www.rust-lang.org/conduct.html
+
+
+## Running the tests
+
+To run Cargo's tests, use `cargo test`. If you do not have the cross-compilers
+installed locally, ignore the cross-compile test failures, or disable them by
+using `CFG_DISABLE_CROSS_TESTS=1 cargo test`. Note that some tests are enabled
+only on nightly toolchain.
+
+
+## Contributing to the Docs
+
+To contribute to the docs, all you need to do is change the markdown files in
+the `src/doc` directory. To view the rendered version of changes you have
+made locally, run:
+
+```sh
+sh src/ci/dox.sh
+open target/doc/index.html
+```
+
+
+## Getting help
+
+If you need some pointers about Cargo's internals, feel free to ask questions
+on the relevant issue or on the [IRC].
+
+[IRC]: https://kiwiirc.com/client/irc.mozilla.org/cargo

diff --git a/README.md b/README.md
index 297452e44f05d67f03c283baa7a1747121f6154d..b853fdeae77c93003398bc1376eb1bd84e674bff 100644 (file)
--- a/README.md
+++ b/README.md
@@ -34,12 +34,6 @@ With `cargo` already installed, you can simply run:
 cargo build --release
 ```
 
-## Running the tests
-
-To run cargo's tests, use `cargo test`. If you do not have the cross-compilers
-installed locally, ignore the cross-compile test failures, or disable them by
-using `CFG_DISABLE_CROSS_TESTS=1 cargo test`.
-
 ## Adding new subcommands to Cargo
 
 Cargo is designed to be extensible with new subcommands without having to modify
@@ -48,16 +42,6 @@ a list of known community-developed subcommands.
 
 [third-party-subcommands]: https://github.com/rust-lang/cargo/wiki/Third-party-cargo-subcommands
 
-## Contributing to the Docs
-
-To contribute to the docs, all you need to do is change the markdown files in
-the `src/doc` directory. To view the rendered version of changes you have
-made locally, run:
-
-```sh
-sh src/ci/dox.sh
-open target/doc/index.html
-```
 
 ## Releases
 
@@ -95,6 +79,12 @@ Please report all issues on the github [issue tracker][issues].
 
 [issues]: https://github.com/rust-lang/cargo/issues
 
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md)
+
+
 ## License
 
 Cargo is primarily distributed under the terms of both the MIT license