diff --git a/src/doc/src/reference/manifest.md b/src/doc/src/reference/manifest.md
index e9957bd90ab..c77bbdbf565 100644
--- a/src/doc/src/reference/manifest.md
+++ b/src/doc/src/reference/manifest.md
@@ -119,21 +119,20 @@ brackets at the end of each author.
 <a id="the-edition-field-optional"></a>
 #### The `edition` field
 
-The `edition` key is an optional key that affects which edition your package
+The `edition` key is an optional key that affects which [Rust Edition] your package
 is compiled with. [`cargo new`] will generate a package with the `edition` key
 set to the latest edition. Setting the `edition` key in
 `[package]` will affect all targets/crates in the package, including test
 suites, benchmarks, binaries, examples, etc.
 
-If the `edition` key is not set to a specific [Rust Edition] in your
-`Cargo.toml`, Cargo will default to 2015.
-
 ```toml
 [package]
 # ...
 edition = '2018'
 ```
 
+If the `edition` key is not set in your `Cargo.toml`, Cargo will default to 2015.
+
 #### The `description` field
 
 The description is a short blurb about the package. [crates.io] will display