diff --git a/gio/gsimpleproxyresolver.c b/gio/gsimpleproxyresolver.c
index d0480a814..5ec998525 100644
--- a/gio/gsimpleproxyresolver.c
+++ b/gio/gsimpleproxyresolver.c
@@ -33,19 +33,16 @@
 #include "glibintl.h"
 
 /**
- * SECTION:gsimpleproxyresolver
- * @short_description: Simple proxy resolver implementation
- * @include: gio/gio.h
- * @see_also: g_socket_client_set_proxy_resolver()
+ * GSimpleProxyResolver:
  *
- * #GSimpleProxyResolver is a simple #GProxyResolver implementation
+ * `GSimpleProxyResolver` is a simple [iface@Gio.ProxyResolver] implementation
  * that handles a single default proxy, multiple URI-scheme-specific
  * proxies, and a list of hosts that proxies should not be used for.
  *
- * #GSimpleProxyResolver is never the default proxy resolver, but it
+ * `GSimpleProxyResolver` is never the default proxy resolver, but it
  * can be used as the base class for another proxy resolver
  * implementation, or it can be created and used manually, such as
- * with g_socket_client_set_proxy_resolver().
+ * with [method@Gio.SocketClient.set_proxy_resolver].
  *
  * Since: 2.36
  */
diff --git a/gio/gsimpleproxyresolver.h b/gio/gsimpleproxyresolver.h
index 2e5f4b2a8..113b49118 100644
--- a/gio/gsimpleproxyresolver.h
+++ b/gio/gsimpleproxyresolver.h
@@ -36,11 +36,6 @@ G_BEGIN_DECLS
 #define G_IS_SIMPLE_PROXY_RESOLVER_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_SIMPLE_PROXY_RESOLVER))
 #define G_SIMPLE_PROXY_RESOLVER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_SIMPLE_PROXY_RESOLVER, GSimpleProxyResolverClass))
 
-/**
- * GSimpleProxyResolver:
- *
- * A #GProxyResolver implementation for using a fixed set of proxies.
- **/
 typedef struct _GSimpleProxyResolver GSimpleProxyResolver;
 typedef struct _GSimpleProxyResolverPrivate GSimpleProxyResolverPrivate;
 typedef struct _GSimpleProxyResolverClass GSimpleProxyResolverClass;