diff --git a/gio/gsimplepermission.c b/gio/gsimplepermission.c
index 36358eb08..316550992 100644
--- a/gio/gsimplepermission.c
+++ b/gio/gsimplepermission.c
@@ -25,24 +25,15 @@
 #include "gpermission.h"
 
 
-/**
- * SECTION:gsimplepermission
- * @title: GSimplePermission
- * @short_description: A GPermission that doesn't change value
- * @include: gio/gio.h
- *
- * #GSimplePermission is a trivial implementation of #GPermission that
- * represents a permission that is either always or never allowed.  The
- * value is given at construction and doesn't change.
- *
- * Calling request or release will result in errors.
- **/
-
 /**
  * GSimplePermission:
  *
- * #GSimplePermission is an opaque data structure.  There are no methods
- * except for those defined by #GPermission.
+ * `GSimplePermission` is a trivial implementation of [class@Gio.Permission]
+ * that represents a permission that is either always or never allowed.  The
+ * value is given at construction and doesn’t change.
+ *
+ * Calling [method@Gio.Permission.acquire] or [method@Gio.Permission.release]
+ * on a `GSimplePermission` will result in errors.
  **/
 
 typedef GPermissionClass GSimplePermissionClass;