diff --git a/gio/gsimpleaction.c b/gio/gsimpleaction.c
index 4e7e5b5ee..1ffc71ac5 100644
--- a/gio/gsimpleaction.c
+++ b/gio/gsimpleaction.c
@@ -26,25 +26,15 @@
 #include "gaction.h"
 #include "glibintl.h"
 
-/**
- * SECTION:gsimpleaction
- * @title: GSimpleAction
- * @short_description: A simple GAction implementation
- * @include: gio/gio.h
- *
- * A #GSimpleAction is the obvious simple implementation of the #GAction
- * interface. This is the easiest way to create an action for purposes of
- * adding it to a #GSimpleActionGroup.
- *
- * See also #GtkAction.
- */
-
 /**
  * GSimpleAction:
  *
- * #GSimpleAction is an opaque data structure and can only be accessed
- * using the following functions.
- **/
+ * A `GSimpleAction` is the obvious simple implementation of the
+ * [iface@Gio.Action] interface. This is the easiest way to create an action for
+ * purposes of adding it to a [class@Gio.SimpleActionGroup].
+ *
+ * See also [class@Gtk.Action].
+ */
 
 struct _GSimpleAction
 {