diff --git a/src/adapters/mod.rs b/src/adapters/mod.rs
index 5f0a773..e181d77 100644
--- a/src/adapters/mod.rs
+++ b/src/adapters/mod.rs
@@ -5,8 +5,8 @@
 //!
 //! Feature sides: the `from_*` import adapters compile under `client`;
 //! `to_openapi` / `to_mcp` under `server`; the shared
-//! [`OpenAPISpec`] document model under `openapi` (implied by both
-//! sides).
+//! `openapi_spec::OpenAPISpec` document model under `openapi`
+//! (implied by both sides).
 
 #[cfg(any(feature = "client", all(feature = "server", feature = "openapi")))]
 pub mod input_validation;
diff --git a/src/server/adapter.rs b/src/server/adapter.rs
index 91cd56c..24d99eb 100644
--- a/src/server/adapter.rs
+++ b/src/server/adapter.rs
@@ -271,7 +271,8 @@ impl HttpAdapter {
     /// Unit 2): one [`OpenableAlpn`](crate::websocket::OpenableAlpn)
     /// per openable data-channel ALPN — the open-op spec (with the
     /// `channel_open` marker) and the ALPN-specific
-    /// [`OpenHandler`](crate::websocket::OpenHandler). Each WS
+    /// [`OpenHandler`](alkcall::channels::operations::OpenHandler).
+    /// Each WS
     /// session's per-session fork registers the set (plus the generic
     /// channel ops, bootstrap discovery, and `op/register`), so a WS
     /// client can open data channels exactly as any channels consumer
diff --git a/src/websocket/mod.rs b/src/websocket/mod.rs
index 1ff483f..e548301 100644
--- a/src/websocket/mod.rs
+++ b/src/websocket/mod.rs
@@ -9,7 +9,7 @@
 //! alkcall's byte-oriented channels machinery — shared with the
 //! `from_wss` consumer path ([ADR-070]).
 //!
-//! Feature sides: [`upgrade`] (and the axum flavor of the adapter)
+//! Feature sides: `upgrade` (and the axum flavor of the adapter)
 //! compile under `server`; the tungstenite flavor compiles under `wss`
 //! (and under `test-support`); both are available with both features.
 
diff --git a/src/websocket/upgrade.rs b/src/websocket/upgrade.rs
index c9b4cf1..e900ac1 100644
--- a/src/websocket/upgrade.rs
+++ b/src/websocket/upgrade.rs
@@ -212,7 +212,9 @@ impl WsSessions {
         self.sessions.lock().is_empty()
     }
 
-    /// The live session's channel-0 [`CallConnection`] handles (WS-26):
+    /// The live session's channel-0
+    /// [`CallConnection`](alkcall::protocol::connection::CallConnection)
+    /// handles (WS-26):
     /// the deployment-visible surface the assembly layer (or the hub)
     /// reaches browser/session-side ops through — connection-local
     /// overlay composition, `announce_op`-style pushes, session
@@ -288,7 +290,7 @@ impl OpenableAlpn {
 /// progress. `write_timeout` bounds one outbound WS send (WS-18):
 /// `None` = the crate default window, `Some(d)` a deployment-set
 /// window. `openable_alpns` (WS-22) is the deployment's openable-ALPN
-/// set registered per session (see [`install_channel_zero`]).
+/// set registered per session (see the `install_channel_zero` hook).
 /// `op_register_acl` (review 007 WS-29) is the `op/register`
 /// surface's `AccessControl` — `AccessControl::default()` (the
 /// permissive crate default) unless a deployment restricts which