mention the overview chapter

1 files changed, 7 insertions, 0 deletions

diff --git a/src/doc/rustc-dev-guide/src/compiler-src.md b/src/doc/rustc-dev-guide/src/compiler-src.md
index 67940d367df..a9d708f1a88 100644
--- a/src/doc/rustc-dev-guide/src/compiler-src.md
+++ b/src/doc/rustc-dev-guide/src/compiler-src.md
@@ -5,6 +5,9 @@
 > top-level directory has separate directories for the compiler, build-system,
 > std libs, etc, rather than one huge `src/` directory.
 
+Now that we have [seen what the compiler does](./overview.md), let's take a
+look at the structure of the contents of the rust-lang/rust repo.
+
 ## Workspace structure
 
 The `rust-lang/rust` repository consists of a single large cargo workspace
@@ -35,6 +38,10 @@ built in a special way because it can use unstable features.
 
 ## Compiler
 
+> You may find it helpful to read [The Overview Chapter](./overview.md) first,
+> which gives an overview of how the compiler works. The crates mentioned in
+> this section implement the compiler.
+
 The compiler crates all have names starting with `librustc_*`. These are a large
 collection of interdependent crates. There is also the `rustc` crate which is
 the actual binary. It doesn't actually do anything besides calling the compiler