diff --git a/src/pipewire/impl-client.h b/src/pipewire/impl-client.h
index f9278f5f8..de9325cbd 100644
--- a/src/pipewire/impl-client.h
+++ b/src/pipewire/impl-client.h
@@ -12,6 +12,8 @@ extern "C" {
 #include <spa/utils/hook.h>
 
 /** \page page_client_impl Client Implementation
+ *
+ * \see \ref pw_impl_client
  *
  * \section sec_page_client_impl_overview Overview
  *
@@ -51,7 +53,7 @@ extern "C" {
  * Each client has its own list of resources it is bound to along with
  * a mapping between the client types and server types.
  *
- * See: \ref page_client_impl
+ * \see \ref page_client_impl
  */
 
 /**
diff --git a/src/pipewire/proxy.h b/src/pipewire/proxy.h
index e92a44e43..b46c41725 100644
--- a/src/pipewire/proxy.h
+++ b/src/pipewire/proxy.h
@@ -12,6 +12,8 @@ extern "C" {
 #include <spa/utils/hook.h>
 
 /** \page page_proxy Proxy
+ *
+ * \see \ref pw_proxy
  *
  * \section sec_page_proxy_overview Overview
  *
@@ -76,7 +78,7 @@ extern "C" {
  * invoked by the client to PipeWire messages. Events will call the handlers
  * set in listener.
  *
- * See \ref page_proxy
+ * \see \ref page_proxy
  */
 
 /**
diff --git a/src/pipewire/stream.h b/src/pipewire/stream.h
index f394eaf0b..bea90b458 100644
--- a/src/pipewire/stream.h
+++ b/src/pipewire/stream.h
@@ -10,6 +10,8 @@ extern "C" {
 #endif
 
 /** \page page_streams Streams
+ *
+ * \see \ref pw_stream
  *
  * \section sec_overview Overview
  *
@@ -162,7 +164,7 @@ extern "C" {
  * The stream object provides a convenient way to send and
  * receive data streams from/to PipeWire.
  *
- * See also \ref page_streams and \ref api_pw_core
+ * \see \ref page_streams, \ref api_pw_core
  */
 
 /**
diff --git a/src/pipewire/thread-loop.h b/src/pipewire/thread-loop.h
index 1d5725f03..f1eb1910e 100644
--- a/src/pipewire/thread-loop.h
+++ b/src/pipewire/thread-loop.h
@@ -12,6 +12,8 @@ extern "C" {
 #include <pipewire/loop.h>
 
 /** \page page_thread_loop Thread Loop
+ *
+ * \see \ref pw_thread_loop
  *
  * \section sec_thread_loop_overview Overview
  *
@@ -68,7 +70,7 @@ extern "C" {
  * All of the loop callbacks will be executed with the loop
  * lock held.
  *
- * See also \ref page_thread_loop
+ * \see \ref page_thread_loop
  */
 
 /**