diff --git a/astrid-sdk/src/interceptors.rs b/astrid-sdk/src/interceptors.rs
index 34549e5..0b201ba 100644
--- a/astrid-sdk/src/interceptors.rs
+++ b/astrid-sdk/src/interceptors.rs
@@ -36,8 +36,8 @@ impl InterceptorBinding {
 /// Query the runtime for auto-subscribed interceptor handles.
 ///
 /// Returns an empty vec if this capsule has no auto-subscribed
-/// interceptors (i.e. it does not have both `run()` and
-/// `[[interceptor]]`). Each entry maps an action name to the IPC
+/// interceptors (i.e. it does not have both `run()` and a `[subscribe]`
+/// entry with a `handler`). Each entry maps an action name to the IPC
 /// topic the kernel routes through `astrid-hook-trigger`.
 pub fn bindings() -> Result<Vec<InterceptorBinding>, SysError> {
     let handles = wit_ipc::get_interceptor_bindings().map_err(host_err)?;
diff --git a/astrid-sdk/src/lib.rs b/astrid-sdk/src/lib.rs
index c57b8dc..e40f8c5 100644
--- a/astrid-sdk/src/lib.rs
+++ b/astrid-sdk/src/lib.rs
@@ -522,10 +522,11 @@ pub mod elicit;
 
 /// Auto-subscribed interceptor bindings for run-loop capsules.
 ///
-/// When a capsule declares both `run()` and `[[interceptor]]`, the runtime
-/// auto-subscribes to each interceptor's topic and delivers events through
-/// the IPC channel the run loop already reads from. This module provides
-/// helpers to query the subscription mappings and dispatch events by action.
+/// When a capsule declares both `run()` and a `[subscribe]` entry with a
+/// `handler`, the runtime auto-subscribes to each interceptor's topic and
+/// delivers events through the IPC channel the run loop already reads from.
+/// This module provides helpers to query the subscription mappings and
+/// dispatch events by action.
 pub mod interceptors;
 
 /// Request human approval for sensitive actions from within a capsule.