diff --git a/gio/gconverteroutputstream.c b/gio/gconverteroutputstream.c
index b26f645d4..046958801 100644
--- a/gio/gconverteroutputstream.c
+++ b/gio/gconverteroutputstream.c
@@ -33,17 +33,14 @@
 
 
 /**
- * SECTION:gconverteroutputstream
- * @short_description: Converter Output Stream
- * @include: gio/gio.h
- * @see_also: #GOutputStream, #GConverter
+ * GConverterOutputStream:
  *
- * Converter output stream implements #GOutputStream and allows
+ * Converter output stream implements [iface@Gio.OutputStream] and allows
  * conversion of data of various types during reading.
  *
- * As of GLib 2.34, #GConverterOutputStream implements
- * #GPollableOutputStream.
- **/
+ * As of GLib 2.34, `GConverterOutputStream` implements
+ * [iface@Gio.PollableOutputStream].
+ */
 
 #define INITIAL_BUFFER_SIZE 4096
 
diff --git a/gio/gconverteroutputstream.h b/gio/gconverteroutputstream.h
index c09084606..e184500b0 100644
--- a/gio/gconverteroutputstream.h
+++ b/gio/gconverteroutputstream.h
@@ -39,12 +39,6 @@ G_BEGIN_DECLS
 #define G_IS_CONVERTER_OUTPUT_STREAM_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_CONVERTER_OUTPUT_STREAM))
 #define G_CONVERTER_OUTPUT_STREAM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_CONVERTER_OUTPUT_STREAM, GConverterOutputStreamClass))
 
-/**
- * GConverterOutputStream:
- *
- * An implementation of #GFilterOutputStream that allows data
- * conversion.
- **/
 typedef struct _GConverterOutputStreamClass    GConverterOutputStreamClass;
 typedef struct _GConverterOutputStreamPrivate  GConverterOutputStreamPrivate;