diff --git a/README.md b/README.md
index f1a6e02a1..e09ce1868 100644
--- a/README.md
+++ b/README.md
@@ -7,38 +7,38 @@
diff --git a/packages/core/src/lib.rs b/packages/core/src/lib.rs
index b588215b3..ff600f6c9 100644
--- a/packages/core/src/lib.rs
+++ b/packages/core/src/lib.rs
@@ -4,7 +4,7 @@
/*
Navigating this crate:
- virtual_dom: the primary entrypoint for the crate
-- scheduler: the core interior logic called by virtual_dom
+- scheduler: the core interior logic called by the [`VirtualDom`]
- nodes: the definition of VNodes, listeners, etc.
- diff: the stackmachine-based diffing algorithm
- hooks: foundational hooks that require crate-private APIs