last updates to the blog post

Author: pietroalbini

posts/2019-10-15-Rustup-1.20.0.md

@@ -12,6 +12,12 @@ If you have a previous version of rustup installed, getting rustup 1.20.0 is as
 rustup self update
 ```
 
+Rustup will also automatically update itself at the end of a normal toolchain update:
+
+```
+rustup update
+```
+
 If you don't have it already, you can [get rustup][install] from the appropriate page on our website.
 
 [rust]: https://www.rust-lang.org
@@ -25,9 +31,9 @@ The highlights of this release are profiles support, the ability to get the late
 
 ### Profiles
 
-Previous versions of rustup installed a few components by default along with each toolchain: the compiler (`rustc`), the package manager (`cargo`), the standard library (`rust-std`), and offline documentation (`rust-docs`). While this approach is fine while developing software locally, some of the components (like `rust-docs`) slowed down the installation due to the large amount of installed files, especially on CIs and on Windows.
+Previous versions of rustup installed a few components by default along with each toolchain: the compiler (`rustc`), the package manager (`cargo`), the standard library (`rust-std`), and offline documentation (`rust-docs`). While this approach is fine while developing software locally, some of the components (like `rust-docs`) slowed down the installation, either because they're not used on build servers, or on Windows due to the large amount of installed files.
 
-To address this problem, rustup 1.20.0 introduces the concept of "profiles". They are groups of components you can choose to download while installing a Rust toolchain. The profiles available at this time are `minimal`, `default`, and `complete`:
+To address this problem, rustup 1.20.0 introduces the concept of "profiles". They are groups of components you can choose to download while installing a new Rust toolchain. The profiles available at this time are `minimal`, `default`, and `complete`:
 
 * The **minimal** profile includes as few components as possible to get a working compiler (`rustc`, `rust-std`, and `cargo`). It's recommended to use this component on Windows systems if you don't use local documentation, and in CI.
 * The **default** profile includes all the components previously installed by default (`rustc`, `rust-std`, `cargo`, and `rust-docs`) plus `rustfmt` and `clippy`. This profile will be used by rustup by default, and it's the one recommended for general use.
@@ -39,7 +45,7 @@ To change the rustup profile you can use the `rustup set profile` command. For e
 rustup set profile minimal
 ```
 
-It's also possible to choose the profile at installation time, either interactively by choosing the "Customize installation" option or programmaticaly by passing the `--profile=<name>` flag. As usual it will be possible to install individual components not included in your profile with: `rustup component add`.
+It's also possible to choose the profile when installing rustup for the first time, either interactively by choosing the "Customize installation" option or programmaticaly by passing the `--profile=<name>` flag. Profiles will only affect newly installed toolchains: as usual it will be possible to install individual components later with: `rustup component add`.
 
 ### Installing the latest compatible nightly
 
@@ -59,22 +65,22 @@ The `rustup doc` command opens the locally installed documentation on your brows
 rustup doc std::iter::Iterator
 ```
 
-This works for traits, structs/enums, macros, and modules, and can take you to the `std`, `alloc`, and `core` crates. We will be improving the command's UX over time, so if you have ideas, please do let us know!
+This works for traits, structs/enums, macros, and modules, and can take you to the `std`, `alloc`, and `core` crates. Note, however, that this functionality will only work if you have the `rust-docs` component installed in your toolchain. We will be improving the command's UX over time, so if you have ideas, please do let us know!
 
 [`Iterator`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html
 
 ## Thanks
 
 Thanks to all the contributors who made rustup 1.20.0 possible!
 
-- Nick Cameron
 - Andy McCaffrey
-- Pietro Albini
-- Benjamin Chen
 - Artem Borisovskiy
+- Benjamin Chen
+- Daniel Silverstone
 - Jon Gjengset
 - Lzu Tao
-- Daniel Silverstone
-- PicoJr
-- Mitchell Hynes
 - Matt Kantor
+- Mitchell Hynes
+- Nick Cameron
+- PicoJr
+- Pietro Albini