diff --git a/docs/crates/README.md b/docs/crates/README.md
index 75348807..492dfd52 100644
--- a/docs/crates/README.md
+++ b/docs/crates/README.md
@@ -3,8 +3,8 @@
 One page per Rust workspace crate — its own `README.md`, unchanged, served
 here for browsing alongside the rest of the docs site. **The crate's own
 `README.md` is the source of truth; nothing here is hand-maintained.**
-Every page is generated at build time (`nix/packages/reference-docs.nix`,
-hyperhive#3051) straight from the crate's real `README.md`, so it can never
+`nix/packages/reference-docs.nix` (hyperhive#3051) generates every page at
+build time straight from the crate's real `README.md`, so it can never
 drift out of sync the way a hand-copied mirror would — edit the crate's
 own README to change what shows up here.