[doc/book] Final touches to introduction.md

diff --git a/src/doc/book/src/introduction.md b/src/doc/book/src/introduction.md
index 4ecf1a7d8ba4f6b89746b39056d0b8134984f30d..ddbd8b16349a10d2ed802fe9f3011d06405a6a1c 100644 (file)
--- a/src/doc/book/src/introduction.md
+++ b/src/doc/book/src/introduction.md
@@ -7,45 +7,22 @@ dependencies, compiles your project, makes packages, and upload them to
 [crates.io], the Rust *package registry*.
 
 
-## [Getting Started](getting-started.html)
+### Sections
 
-To get started with Cargo, install Cargo (and Rust) and set up your first crate.
+**[Getting Started](getting-started.html)**
 
-* [Installation](getting-started/installation.html)
-* [First Steps with Cargo](getting-started/first-steps.html)
+To get started with Cargo, install Cargo (and Rust) and set up your first crate.
 
-## [Cargo Guide](guide.html)
+**[Cargo Guide](guide.html)**
 
 The guide will give you all you need to know about how to use Cargo to develop
 Rust projects.
 
-* [Why Cargo exists](guide/why-cargo-exists.html)
-* [Creating a new project](guide/creating-a-new-project.html)
-* [Working on an existing Cargo
-    project](guide/working-on-an-existing-project.html)
-* [Dependencies](guide/dependencies.html)
-* [Project layout](guide/project-layout.html)
-* [Cargo.toml vs Cargo.lock](guide/cargo-toml-vs-cargo-lock.html)
-* [Tests](guide/tests.html)
-* [Continuous Integration](guide/continuous-integration.html)
-
-## [Cargo Reference](reference.html)
-
-After having an overview of how to use Cargo and have created your first crate,
-you may be interested in more details in the following areas.
-
-* [Specifying Dependencies](reference/specifying-dependencies.html)
-* [The Manifest Format](reference/manifest.html)
-* [Configuration](reference/config.html)
-* [Environment Variables](reference/environment-variables.html)
-* [Build Scripts](reference/build-scripts.html)
-* [Publishing on crates.io](reference/crates-io.html)
-* [Package ID Specifications](reference/pkgid-spec.html)
-* [Source Replacement](reference/source-replacement.html)
-* [External Tools](reference/external-tools.html)
-* [Crates.io Package Policies](reference/policies.html)
-
-## [Frequently Asked Questions](faq.html)
+**[Cargo Reference](reference.html)**
+
+The reference covers the details of various areas of Cargo.
+
+**[Frequently Asked Questions](faq.html)**
 
 [rust]: https://www.rust-lang.org/
 [crates.io]: https://crates.io/

diff --git a/src/doc/book/src/reference.md b/src/doc/book/src/reference.md
index 1c034b7dbc90621a1b64a288a3d8be2e89b292d0..dd3f724cb5f61e4630cec117700768d7a987992f 100644 (file)
--- a/src/doc/book/src/reference.md
+++ b/src/doc/book/src/reference.md
@@ -3,6 +3,8 @@
 Now that you have an overview of how to use Cargo and have created your first
 crate, you may be interested in more details in the following areas.
 
+The reference covers the details of various areas of Cargo.
+
 * [Specifying Dependencies](reference/specifying-dependencies.html)
 * [The Manifest Format](reference/manifest.html)
 * [Configuration](reference/config.html)