diff --git a/gio/gproxy.c b/gio/gproxy.c
index 40ba78f7c..31d32245f 100644
--- a/gio/gproxy.c
+++ b/gio/gproxy.c
@@ -29,16 +29,14 @@
 #include "glibintl.h"
 
 /**
- * SECTION:gproxy
- * @short_description: Interface for proxy handling
- * @include: gio/gio.h
+ * GProxy:
  *
- * A #GProxy handles connecting to a remote host via a given type of
- * proxy server. It is implemented by the 'gio-proxy' extension point.
+ * A `GProxy` handles connecting to a remote host via a given type of
+ * proxy server. It is implemented by the `gio-proxy` extension point.
  * The extensions are named after their proxy protocol name. As an
  * example, a SOCKS5 proxy implementation can be retrieved with the
- * name 'socks5' using the function
- * g_io_extension_point_get_extension_by_name().
+ * name `socks5` using the function
+ * [method@Gio.IOExtensionPoint.get_extension_by_name].
  *
  * Since: 2.26
  **/
diff --git a/gio/gproxy.h b/gio/gproxy.h
index de82410f9..9fcf7cc01 100644
--- a/gio/gproxy.h
+++ b/gio/gproxy.h
@@ -48,13 +48,6 @@ G_BEGIN_DECLS
  */
 #define G_PROXY_EXTENSION_POINT_NAME "gio-proxy"
 
-/**
- * GProxy:
- *
- * Interface that handles proxy connection and payload.
- *
- * Since: 2.26
- */
 typedef struct _GProxyInterface GProxyInterface;
 
 /**