diff --git a/buffa-build/src/lib.rs b/buffa-build/src/lib.rs
index f7aa5ce..8292bef 100644
--- a/buffa-build/src/lib.rs
+++ b/buffa-build/src/lib.rs
@@ -256,9 +256,10 @@ impl Config {
     /// `buffa-descriptor`-dependent (and `std`-requiring) reflection surface to
     /// be opt-in. `buffa-types` is the motivating case.
     ///
-    /// **Experimental and `#[doc(hidden)]`**, paired with
-    /// [`generate_reflection_vtable`](Self::generate_reflection_vtable) until the
-    /// public `ReflectMode` selector lands.
+    /// **Experimental and `#[doc(hidden)]`.** This knob only controls the
+    /// crate-feature gate on the emitted reflection impls; the reflection
+    /// codegen mode itself is selected via the public
+    /// [`reflect_mode`](Self::reflect_mode) selector.
     #[doc(hidden)]
     #[must_use]
     pub fn gate_reflect_on_crate_feature(mut self, enabled: bool) -> Self {
diff --git a/buffa-codegen/src/lib.rs b/buffa-codegen/src/lib.rs
index 2cc76e4..60ed075 100644
--- a/buffa-codegen/src/lib.rs
+++ b/buffa-codegen/src/lib.rs
@@ -1169,7 +1169,7 @@ pub struct CodeGenConfig {
     /// A low-level knob for crates whose generated code is a public interface
     /// (`buffa-types`, the conformance harness). Set directly by `gen_wkt_types`
     /// and exposed through `buffa_build::Config::gate_reflect_on_crate_feature`
-    /// (currently `#[doc(hidden)]`, paired with the experimental vtable flag).
+    /// (currently `#[doc(hidden)]`).
     ///
     /// Defaults to `false`.
     pub gate_reflect_on_crate_feature: bool,