diff --git a/glib/gerror.c b/glib/gerror.c
index 4e0ee4c41..82bf626ed 100644
--- a/glib/gerror.c
+++ b/glib/gerror.c
@@ -375,6 +375,8 @@
  *   location is either %NULL or contains a %NULL error (e.g.
  *   `g_return_if_fail (error == NULL || *error == NULL);`).
  *
+ * ## Extended #GError Domains # {#gerror-extended-domains}
+ *
  * Since GLib 2.68 it is possible to extend the #GError type. This is
  * done with the G_DEFINE_EXTENDED_ERROR() macro. To create an
  * extended #GError type do something like this in the header file:
diff --git a/glib/gerror.h b/glib/gerror.h
index 8773a1023..2a31e909e 100644
--- a/glib/gerror.h
+++ b/glib/gerror.h
@@ -65,6 +65,8 @@ struct _GError
  * respectively, but they should receive the private data type instead
  * of #GError.
  *
+ * See [Extended #GError Domains][gerror-extended-domains] for an example.
+ *
  * Since: 2.68
  */
 #define G_DEFINE_EXTENDED_ERROR(ErrorType, error_type)                  \