diff --git a/gio/gdbusobject.c b/gio/gdbusobject.c
index 5cd425e17..ab670d20c 100644
--- a/gio/gdbusobject.c
+++ b/gio/gdbusobject.c
@@ -28,22 +28,13 @@
 
 #include "glibintl.h"
 
-/**
- * SECTION:gdbusobject
- * @short_description: Base type for D-Bus objects
- * @include: gio/gio.h
- *
- * The #GDBusObject type is the base type for D-Bus objects on both
- * the service side (see #GDBusObjectSkeleton) and the client side
- * (see #GDBusObjectProxy). It is essentially just a container of
- * interfaces.
- */
-
 /**
  * GDBusObject:
  *
- * #GDBusObject is an opaque data structure and can only be accessed
- * using the following functions.
+ * The `GDBusObject` type is the base type for D-Bus objects on both
+ * the service side (see [class@Gio.DBusObjectSkeleton]) and the client side
+ * (see [class@Gio.DBusObjectProxy]). It is essentially just a container of
+ * interfaces.
  */
 
 typedef GDBusObjectIface GDBusObjectInterface;