add a few more TOC sections

src/bug-fix-procedure.md

@@ -174,7 +174,7 @@ public github repos with the compiler with your changes. A report will then be
 generated with crates that ceased to compile with or began to compile with your
 changes. Crater runs can take a few days to complete.
 
-[Crater]: https://github.com/rust-lang/crater
+[Crater]: ./tests/crater.md
 
 We should always do a crater run to assess impact. It is polite and considerate
 to at least notify the authors of affected crates the breaking change. If we can

src/building/how-to-build-and-run.md

@@ -1,5 +1,7 @@
 # How to build and run the compiler
 
+<!-- toc -->
+
 The compiler is built using a tool called `x.py`. You will need to
 have Python installed to run it.
 

src/building/new-target.md

@@ -4,6 +4,8 @@ These are a set of steps to add support for a new target. There are
 numerous end states and paths to get there, so not all sections may be
 relevant to your desired goal.
 
+<!-- toc -->
+
 ## Specifying a new LLVM
 
 For very new targets, you may need to use a different fork of LLVM

src/building/suggested.md

@@ -3,6 +3,8 @@
 The full bootstrapping process takes quite a while. Here are some suggestions
 to make your life easier.
 
+<!-- toc -->
+
 ## Installing a pre-push hook
 
 CI will automatically fail your build if it doesn't pass `tidy`, our

src/contributing.md

@@ -1,5 +1,7 @@
 # Contribution Procedures
 
+<!-- toc -->
+
 ## Bug Reports
 
 While bugs are unfortunate, they're a reality in software. We can't fix what we

src/implementing_new_features.md

@@ -1,5 +1,7 @@
 # Implementing new features
 
+<!-- toc -->
+
 When you want to implement a new significant feature in the compiler,
 you need to go through this process to make sure everything goes
 smoothly.

src/rustdoc.md

@@ -1,8 +1,5 @@
 # Rustdoc overview
 
-`rustdoc` uses `rustc` internals (and, of course, the standard library), so you
-will have to build the compiler and `std` once before you can build `rustdoc`.
-
 `rustdoc` lives in-tree with the
 compiler and standard library. This chapter is about how it works.
 For information about Rustdoc's features and how to use them, see
@@ -12,6 +9,11 @@ For more details about how rustdoc works, see the
 
 [Rustdoc internals]: ./rustdoc-internals.md
 
+<!-- toc -->
+
+`rustdoc` uses `rustc` internals (and, of course, the standard library), so you
+will have to build the compiler and `std` once before you can build `rustdoc`.
+
 Rustdoc is implemented entirely within the crate [`librustdoc`][rd]. It runs
 the compiler up to the point where we have an internal representation of a
 crate (HIR) and the ability to run some queries about the types of items. [HIR]