diff --git a/gio/gdbuserror.c b/gio/gdbuserror.c
index 95949ead3..f2778d2d0 100644
--- a/gio/gdbuserror.c
+++ b/gio/gdbuserror.c
@@ -101,9 +101,9 @@
  * of %G_IO_ERROR_DBUS_ERROR. Note that GDBus clients can still recover
  * org.project.Foo.Bar.Error.AnotherError using g_dbus_error_get_remote_error().
  *
- * Note that errors in the %G_DBUS_ERROR error domain is intended only
+ * Note that the %G_DBUS_ERROR error domain is intended only
  * for returning errors from a remote message bus process. Errors
- * generated locally in-process by e.g. #GDBusConnection is from the
+ * generated locally in-process by e.g. #GDBusConnection should use the
  * %G_IO_ERROR domain.
  */
 
diff --git a/gio/gdbuserror.h b/gio/gdbuserror.h
index f30c7e187..35a156cb2 100644
--- a/gio/gdbuserror.h
+++ b/gio/gdbuserror.h
@@ -36,9 +36,9 @@ G_BEGIN_DECLS
  * in this domain will be from the #GDBusError enumeration.  See
  * #GError for more information on error domains.
  *
- * Note that errors in this error domain is intended only for
+ * Note that this error domain is intended only for
  * returning errors from a remote message bus process. Errors
- * generated locally in-process by e.g. #GDBusConnection is from the
+ * generated locally in-process by e.g. #GDBusConnection should use the
  * %G_IO_ERROR domain.
  *
  * Since: 2.26