diff --git a/gio/gtlsclientconnection.c b/gio/gtlsclientconnection.c
index d64106e51..b2b0155fd 100644
--- a/gio/gtlsclientconnection.c
+++ b/gio/gtlsclientconnection.c
@@ -30,20 +30,11 @@
 #include "gtlscertificate.h"
 #include "glibintl.h"
 
-/**
- * SECTION:gtlsclientconnection
- * @short_description: TLS client-side connection
- * @include: gio/gio.h
- *
- * #GTlsClientConnection is the client-side subclass of
- * #GTlsConnection, representing a client-side TLS connection.
- */
-
 /**
  * GTlsClientConnection:
  *
- * Abstract base class for the backend-specific client connection
- * type.
+ * `GTlsClientConnection` is the client-side subclass of
+ * [class@Gio.TlsConnection], representing a client-side TLS connection.
  *
  * Since: 2.28
  */
diff --git a/gio/gtlsserverconnection.c b/gio/gtlsserverconnection.c
index dc9db62bb..10757fde3 100644
--- a/gio/gtlsserverconnection.c
+++ b/gio/gtlsserverconnection.c
@@ -30,12 +30,10 @@
 #include "glibintl.h"
 
 /**
- * SECTION:gtlsserverconnection
- * @short_description: TLS server-side connection
- * @include: gio/gio.h
+ * GTlsServerConnection:
  *
- * #GTlsServerConnection is the server-side subclass of #GTlsConnection,
- * representing a server-side TLS connection.
+ * `GTlsServerConnection` is the server-side subclass of
+ * [class@Gio.TlsConnection], representing a server-side TLS connection.
  *
  * Since: 2.28
  */
diff --git a/gio/gtlsserverconnection.h b/gio/gtlsserverconnection.h
index f84c25b86..7c4e2832d 100644
--- a/gio/gtlsserverconnection.h
+++ b/gio/gtlsserverconnection.h
@@ -34,14 +34,6 @@ G_BEGIN_DECLS
 #define G_IS_TLS_SERVER_CONNECTION(inst)            (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_TLS_SERVER_CONNECTION))
 #define G_TLS_SERVER_CONNECTION_GET_INTERFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), G_TYPE_TLS_SERVER_CONNECTION, GTlsServerConnectionInterface))
 
-/**
- * GTlsServerConnection:
- *
- * TLS server-side connection. This is the server-side implementation
- * of a #GTlsConnection.
- *
- * Since: 2.28
- */
 typedef struct _GTlsServerConnectionInterface GTlsServerConnectionInterface;
 
 /**