message: Clarify cargo manifest edition field docs
diff: @@ -118,9 +118,14 @@ brackets at the end of each author.
  <a id="the-edition-field-optional"></a>
  #### The `edition` field
  -You can opt in to a specific [Rust Edition] for your package with the
  -`edition` key in `Cargo.toml`. If you don't specify the edition, it will
  -default to 2015.
  +The `edition` key is an optional key that affects which edition your package
  +is compiled with. Cargo will always generate packages via [`cargo new`] 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]
  @@ -128,12 +133,6 @@ default to 2015.
  edition = '2018'
  ```
  -The `edition` key affects which edition your package is compiled with. Cargo
  -will always generate packages via [`cargo new`] 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.
  -
  #### The `description` field
  The description is a short blurb about the package. [crates.io] will display
  