Warn if an "all" target is specified, but we don't match anything

[cargo.git] / README.md

diff --git a/README.md b/README.md
index dde37be1baca25b29326a279e03a63f925e68101..6eed7578eb7244ee74d89cc3a99043d120ff609b 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,10 +1,14 @@
+# Cargo
+
 Cargo downloads your Rust project’s dependencies and compiles your project.
 
-Learn more at http://doc.crates.io/
+Learn more at https://doc.rust-lang.org/cargo/
 
 ## Code Status
-[![Build Status](https://travis-ci.org/rust-lang/cargo.svg?branch=master)](https://travis-ci.org/rust-lang/cargo)
-[![Build Status](https://ci.appveyor.com/api/projects/status/github/rust-lang/cargo?branch=master&svg=true)](https://ci.appveyor.com/project/rust-lang-libs/cargo)
+
+[![Build Status](https://dev.azure.com/rust-lang/cargo/_apis/build/status/rust-lang.cargo?branchName=auto-cargo)](https://dev.azure.com/rust-lang/cargo/_build?definitionId=18)
+
+Code documentation: https://docs.rs/cargo/
 
 ## Installing Cargo
 
@@ -15,16 +19,16 @@ locally you probably also have `cargo` installed locally.
 
 Cargo requires the following tools and packages to build:
 
-* `python`
+* `git`
 * `curl` (on Unix)
-* `cmake`
+* `pkg-config` (on Unix, used to figure out the `libssl` headers/libraries)
 * OpenSSL headers (only for Unix, this is the `libssl-dev` package on ubuntu)
 * `cargo` and `rustc`
 
 First, you'll want to check out this repository
 
 ```
-git clone --recursive https://github.com/rust-lang/cargo
+git clone https://github.com/rust-lang/cargo
 cd cargo
 ```
 
@@ -45,40 +49,45 @@ a list of known community-developed subcommands.
 
 ## Releases
 
-High level release notes are available as part of [Rust's release notes][rel].
 Cargo releases coincide with Rust releases.
+High level release notes are available as part of [Rust's release notes][rel].
+Detailed release notes are available in this repo at [CHANGELOG.md].
 
 [rel]: https://github.com/rust-lang/rust/blob/master/RELEASES.md
+[CHANGELOG.md]: CHANGELOG.md
 
 ## Reporting issues
 
 Found a bug? We'd love to know about it!
 
-Please report all issues on the github [issue tracker][issues].
+Please report all issues on the GitHub [issue tracker][issues].
 
 [issues]: https://github.com/rust-lang/cargo/issues
 
-
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md)
+See the **[Cargo Contributor Guide]** for a complete introduction
+to contributing to Cargo.
 
+[Cargo Contributor Guide]: https://rust-lang.github.io/cargo/contrib/
 
 ## License
 
 Cargo is primarily distributed under the terms of both the MIT license
 and the Apache License (Version 2.0).
 
-See LICENSE-APACHE and LICENSE-MIT for details.
+See [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) for details.
 
 ### Third party software
 
 This product includes software developed by the OpenSSL Project
-for use in the OpenSSL Toolkit (http://www.openssl.org/).
+for use in the OpenSSL Toolkit (https://www.openssl.org/).
 
 In binary form, this product includes software that is licensed under the
 terms of the GNU General Public License, version 2, with a linking exception,
 which can be obtained from the [upstream repository][1].
 
+See [LICENSE-THIRD-PARTY](LICENSE-THIRD-PARTY) for details.
+
 [1]: https://github.com/libgit2/libgit2