diff --git a/src/doctor.rs b/src/doctor.rs
index 58f3e8d..f53f09f 100644
--- a/src/doctor.rs
+++ b/src/doctor.rs
@@ -46,7 +46,7 @@ pub struct DriftShape {
     /// `"bool"`, `"number"`, `"string"`, `"date"`, `"list"`, `"mapping"`.
     pub shape: &'static str,
     pub count: usize,
-    /// Up to [`DRIFT_SAMPLES_PER_SHAPE`] vault-relative paths exhibiting
+    /// Up to `DRIFT_SAMPLES_PER_SHAPE` vault-relative paths exhibiting
     /// this shape, in the order they were scanned.
     pub samples: Vec<String>,
 }
diff --git a/src/query.rs b/src/query.rs
index bf301f7..786e80d 100644
--- a/src/query.rs
+++ b/src/query.rs
@@ -11,7 +11,7 @@
 //! `__in` / `__all` are comma-separated; unknown operators are `400`.
 //!
 //! Predicates are evaluated by iterating the in-memory [`NoteStore`] and
-//! applying each [`Predicate::matches`] in turn. At the documented scale
+//! applying each [`Predicate`] in turn. At the documented scale
 //! (low-thousands-of-notes vaults) this is sub-millisecond; see
 //! [[ADR-009 Reverse ADR-002 In-Memory Evaluation No Tantivy]] for the
 //! call to keep evaluation in-memory rather than carrying a Tantivy index.
diff --git a/src/watcher.rs b/src/watcher.rs
index f004db0..0f7ccc0 100644
--- a/src/watcher.rs
+++ b/src/watcher.rs
@@ -4,7 +4,7 @@
 //! [`notify::RecommendedWatcher`] over the vault root. Each native event is
 //! pushed into a Tokio channel; [`run_debouncer`] drains the channel,
 //! classifies events into [`WatchAction`]s, coalesces a 100 ms window's
-//! worth into one [`Batch`], and casts the batch to the `index_writer`
+//! worth into one [`WatchBatch`], and casts the batch to the `index_writer`
 //! named process for a single [`crate::store::NoteStore`] write.
 //!
 //! See [[ADR-003 Filesystem Change Tracking]] for the event model.
@@ -27,7 +27,7 @@ use crate::vault;
 
 /// One path-scoped action derived from a native filesystem event. Always
 /// carries a vault-relative, forward-slash-normalized path string -- the
-/// same form [`vault::Note.path`] uses.
+/// same form [`vault::Note::path`] uses.
 ///
 /// The `*Tree` variants carry a directory instead of a note. Native events
 /// name only the directory when one is created, removed, or renamed; the