diff --git a/src/doc/index.md b/src/doc/index.md
index 0533f8d751866..144b786f58d24 100644
--- a/src/doc/index.md
+++ b/src/doc/index.md
@@ -13,22 +13,22 @@ builds documentation for individual Rust packages.
 
 ## API Documentation
 
-Rust provides a standard library with a number of features; you can browse
-its documentation [here][api].
+Rust provides a standard library with a number of features; [we host its
+documentation here][api].
 
 ## Reference Documentation
 
-Rust does not yet have a formal specification, but we have a reference document
-[ref][ref]. It is guaranteed to be accurate, but not complete. We now have a
+Rust does not yet have a formal specification, but we have [a reference document
+][ref]. It is guaranteed to be accurate, but not complete. We now have a
 policy that all new features must be included in the reference before
 stabilization; however, we are still back-filling things that landed before
 then. That work is being tracked [here][38643].
 
 ## Extended Error Documentation
 
-All of Rust's errors code with error codes, and you can request extended
-diagnostics from the compiler on those errors. We also produce those
-diagnostics on the web [here][err], if you prefer to read them that way.
+Many of Rust's errors come with error codes, and you can request extended
+diagnostics from the compiler on those errors. We also [have the text of those
+extended errors on the web][err], if you prefer to read them that way.
 
 ## The Rust Bookshelf
 
@@ -36,7 +36,7 @@ Rust provides a number of book-length sets of documentation, collectively
 nicknamed 'The Rust Bookshelf.'
 
 * [The Rust Programming Language][book] teaches you how to program in Rust.
-* [The Rustinomicon][nomicon] is your guidebook to the dark arts of unsafe Rust.
+* [The Rustonomicon][nomicon] is your guidebook to the dark arts of unsafe Rust.
 
 [Rust Learning]: https://github.com/ctjhoa/rust-learning
 [Docs.rs]: https://docs.rs/