diff --git a/docs/reference/gio/dbus-name-watching.md b/docs/reference/gio/dbus-name-watching.md
new file mode 100644
index 000000000..07ff3349a
--- /dev/null
+++ b/docs/reference/gio/dbus-name-watching.md
@@ -0,0 +1,14 @@
+Title: D-Bus Name Watching
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2010 David Zeuthen
+
+# D-Bus Name Watching
+
+Convenience API for watching bus names.
+
+A simple example for watching a name can be found in
+[`gdbus-example-watch-name.c`](https://gitlab.gnome.org/GNOME/glib/-/blob/HEAD/gio/tests/gdbus-example-watch-name.c).
+
+The main API for watching names is:
+ * [func@Gio.bus_watch_name]
+ * [func@Gio.bus_unwatch_name]
diff --git a/docs/reference/gio/gio.toml.in b/docs/reference/gio/gio.toml.in
index 497b57b1b..55c87f75a 100644
--- a/docs/reference/gio/gio.toml.in
+++ b/docs/reference/gio/gio.toml.in
@@ -46,6 +46,7 @@ content_files = [
   "dbus-error.md",
   "dbus-introspection.md",
   "dbus-name-owning.md",
+  "dbus-name-watching.md",
 
   "migrating-gdbus.md",
   "migrating-gconf.md",
diff --git a/docs/reference/gio/meson.build b/docs/reference/gio/meson.build
index af7abbd05..116b45cec 100644
--- a/docs/reference/gio/meson.build
+++ b/docs/reference/gio/meson.build
@@ -228,6 +228,7 @@ expand_content_files = [
   'dbus-error.md',
   'dbus-introspection.md',
   'dbus-name-owning.md',
+  'dbus-name-watching.md',
   'file-attributes.md',
   'migrating-gconf.md',
   'migrating-gdbus.md',
diff --git a/gio/gdbusnamewatching.c b/gio/gdbusnamewatching.c
index c834fe10e..40229f92b 100644
--- a/gio/gdbusnamewatching.c
+++ b/gio/gdbusnamewatching.c
@@ -33,18 +33,6 @@
 
 #include "glibintl.h"
 
-/**
- * SECTION:gdbusnamewatching
- * @title: Watching Bus Names
- * @short_description: Simple API for watching bus names
- * @include: gio/gio.h
- *
- * Convenience API for watching bus names.
- *
- * A simple example for watching a name can be found in
- * [gdbus-example-watch-name.c](https://gitlab.gnome.org/GNOME/glib/-/blob/HEAD/gio/tests/gdbus-example-watch-name.c)
- */
-
 G_LOCK_DEFINE_STATIC (lock);
 
 /* ---------------------------------------------------------------------------------------------------- */