review feedback

Author: steveklabnik

_posts/2017-02-02-Rust-1.15.md

@@ -7,18 +7,24 @@ author: The Rust Core Team
 The Rust team is happy to announce the latest version of Rust, 1.15.0. Rust is a
 systems programming language focused on safety, speed, and concurrency.
 
-As always, you can [install Rust 1.15.0][install] from the appropriate page on our
-website, and check out the [detailed release notes for 1.15.0][notes] on GitHub.
-1443 patches were landed in this release.
+If you have a previous version of Rust installed, getting Rust 1.15 is as easy as:
+
+```bash
+$ rustup update stable
+```
+
+If you don't have it already, you can [get `rustup`][install] from the
+appropriate page on our website, and check out the [detailed release notes for
+1.15.0][notes] on GitHub. 1443 patches were landed in this release.
 
 [install]: https://www.rust-lang.org/install.html
 [notes]: https://github.com/rust-lang/rust/blob/master/RELEASES.md#version-1150-2017-02-02
 
 ### What's in 1.15.0 stable
 
 Rust 1.15 sees an _extremely_ long-awaited feature land on stable: custom
-derive! To review, in Rust, you could automatically implement a trait through
-the `derive` attribute:
+derive! To review, in Rust, you've always been able to automatically implement
+a trait through the `derive` attribute:
 
 ```rust
 #[derive(Debug)]
@@ -27,16 +33,16 @@ struct Pet {
 }
 ```
 
-The `Debug` trait would be implemented for `Pet`. However, this only worked for
+The `Debug` trait is then implemented for `Pet`. However, this only worked for
 traits provided as part of the standard library; it was not customizable. With
 Rust 1.15, it now is. That means, if you want to turn your `Pet` into JSON, it's
 as easy as adding [serde] to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-serde = "0.9.5"
-serde_derive = "0.9.5"
-serde_json = "0.9.3"
+serde = "0.9.0"
+serde_derive = "0.9.0"
+serde_json = "0.9.0"
 ```
 
 [serde]: https://serde.rs
@@ -79,7 +85,7 @@ our `Pet`s in a database. We could do that like this:
 // some extern crate and use lines elided here
 
 #[derive(Queryable)]
-strut Pet {
+struct Pet {
     name: String,
 }
 
@@ -121,6 +127,8 @@ derive was also known as "macros 1.1", as it includes the infrastructure for
 supporting even more compile-time powers of Rust, nicknamed "macros 2.0."
 Expect to hear more about this space in future releases.
 
+#### Other improvements
+
 As a smaller improvement, [`?Sized` can now be used in `where`
 clauses](https://github.com/rust-lang/rust/pull/37791). In other words:
 
@@ -148,13 +156,13 @@ demonstration of the maturity of Cargo.
 [rustbuild]: https://github.com/rust-lang/rust/pull/37817
 [rustbuild-only]: https://github.com/rust-lang/rust/pull/39431
 
-Rust has gained [Tier 3 support][tiers] for `i686-unknown-openbsd`, `MSP430`,
-and `ARMv5TEr`.
+Rust has gained [Tier 3 support][tiers] for [`i686-unknown-openbsd`], [`MSP430`],
+and [`ARMv5TE`].
 
 [tiers]: https://forge.rust-lang.org/platform-support.html
 [`i686-unknown-openbsd`]: https://github.com/rust-lang/rust/pull/38086
 [`MSP430`]: https://github.com/rust-lang/rust/pull/37627
-[`ARMv5TEr`]: https://github.com/rust-lang/rust/pull/37615
+[`ARMv5TE`]: https://github.com/rust-lang/rust/pull/37615
 
 Finally, [a number of compiler performance improvements have
 landed](https://github.com/rust-lang/rust/blob/master/RELEASES.md#compiler-performance).
@@ -219,10 +227,13 @@ See the [detailed release notes][notes] for more.
 
 #### Cargo features
 
-Cargo has received an ergonomics improvement: If you have a file named
-`build.rs` in the root directory, it will [now assume that it's a build script
-][cargo/3361]. Previously, all build scripts required configuration, but this
-convention was strong within the community, so we've encoded it into Cargo.
+Cargo will now [emit a warning][cargo/3361] if you have a file named `build.rs`
+at the top level of a package, but don't have a `build = "build.rs"`
+annotation. This is in anticipation of inferring that `build.rs` at the top
+level is always a build script, but is a warning right now for compatibility
+reasons. Previously, all build scripts required configuration, but this
+convention was strong within the community, so we're going to encode it into
+Cargo.
 
 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361