diff --git a/gio/gnetworkservice.c b/gio/gnetworkservice.c
index dac0814d0..cca17f0af 100644
--- a/gio/gnetworkservice.c
+++ b/gio/gnetworkservice.c
@@ -43,28 +43,19 @@
 
 
 /**
- * SECTION:gnetworkservice
- * @short_description: A GSocketConnectable for resolving SRV records
- * @include: gio/gio.h
+ * GNetworkService:
  *
- * Like #GNetworkAddress does with hostnames, #GNetworkService
+ * Like [class@Gio.NetworkAddress] does with hostnames, `GNetworkService`
  * provides an easy way to resolve a SRV record, and then attempt to
  * connect to one of the hosts that implements that service, handling
  * service priority/weighting, multiple IP addresses, and multiple
  * address families.
  *
- * See #GSrvTarget for more information about SRV records, and see
- * #GSocketConnectable for an example of using the connectable
+ * See [struct@Gio.SrvTarget] for more information about SRV records, and see
+ * [iface@Gio.SocketConnectable] for an example of using the connectable
  * interface.
  */
 
-/**
- * GNetworkService:
- *
- * A #GSocketConnectable for resolving a SRV record and connecting to
- * that service.
- */
-
 struct _GNetworkServicePrivate
 {
   gchar *service, *protocol, *domain, *scheme;