diff --git a/tools/traceability/src/lib.rs b/tools/traceability/src/lib.rs
index 8846d27..fa648fc 100644
--- a/tools/traceability/src/lib.rs
+++ b/tools/traceability/src/lib.rs
@@ -28,11 +28,10 @@
 //! reported implemented on the strength of two string literals in a unit test.
 //!
 //! 3. **A tag is a comment whose first word is `TRACES:`**, not a line in which
-//!    the string appears. This is a rule about position
-//!    rather than about string literals, because `schema.rs` writes real tags
-//!    inside string literals — the SQL it embeds is commented with `--` — and
-//!    an extractor that refused those would lose six genuine tags to save two
-//!    false ones.
+//!    the string appears. See `tag_body`. It is a rule about position rather
+//!    than about string literals, because `schema.rs` writes six real tags
+//!    *inside* string literals — the SQL it embeds is commented with `--` — so
+//!    an extractor that refused string literals would lose more than it saved.
 
 use std::collections::{BTreeMap, BTreeSet};
 use std::path::{Path, PathBuf};