diff --git a/docs/reference/glib/glib.toml.in b/docs/reference/glib/glib.toml.in
index f970ec153..7c126a35c 100644
--- a/docs/reference/glib/glib.toml.in
+++ b/docs/reference/glib/glib.toml.in
@@ -66,6 +66,8 @@ content_files = [
   "goption.md",
   "data-structures.md",
   "unicode.md",
+
+  "threads-deprecated.md",
 ]
 content_images = [
   "file-name-encodings.png",
diff --git a/docs/reference/glib/meson.build b/docs/reference/glib/meson.build
index cf4d95657..1d5c439f5 100644
--- a/docs/reference/glib/meson.build
+++ b/docs/reference/glib/meson.build
@@ -160,6 +160,7 @@ expand_content_files = [
   'running.md',
   'testing.md',
   'threads.md',
+  'threads-deprecated.md',
   'markup.md',
   'goption.md',
   'data-structures.md',
diff --git a/docs/reference/glib/threads-deprecated.md b/docs/reference/glib/threads-deprecated.md
new file mode 100644
index 000000000..4198a6313
--- /dev/null
+++ b/docs/reference/glib/threads-deprecated.md
@@ -0,0 +1,37 @@
+Title: Deprecated Thread API
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2011 Allison Lortie
+
+# Deprecated Thread API
+
+These APIs are deprecated.  You should not use them in new code.
+This section remains only to assist with understanding code that was
+written to use these APIs at some point in the past.
+
+Deprecated thread creation/configuration functions:
+
+ * [type@GLib.ThreadPriority]
+ * [type@GLib.ThreadFunctions]
+ * [func@GLib.Thread.init]
+ * [func@GLib.Thread.get_initialized]
+ * [method@GLib.Thread.set_priority]
+ * [func@GLib.Thread.foreach]
+ * [func@GLib.Thread.create]
+ * [func@GLib.Thread.create_full]
+
+Deprecated static variants of locking primitives:
+
+ * [type@GLib.StaticMutex]
+ * [type@GLib.StaticRecMutex]
+ * [type@GLib.StaticRWLock]
+ * [type@GLib.StaticPrivate]
+
+Deprecated dynamic allocation of locking primitives:
+
+ * [func@GLib.Private.new]
+ * [func@GLib.Mutex.new]
+ * [method@GLib.Mutex.free]
+ * [func@GLib.Cond.new]
+ * [method@GLib.Cond.free]
+ * [method@GLib.Cond.timed_wait]
+
diff --git a/glib/deprecated/gthread-deprecated.c b/glib/deprecated/gthread-deprecated.c
index 49bcf4fca..432f026df 100644
--- a/glib/deprecated/gthread-deprecated.c
+++ b/glib/deprecated/gthread-deprecated.c
@@ -40,17 +40,6 @@
 
 /* {{{1 Documentation */
 
-/**
- * SECTION:threads-deprecated
- * @title: Deprecated thread API
- * @short_description: old thread APIs (for reference only)
- * @see_also: #GThread
- *
- * These APIs are deprecated.  You should not use them in new code.
- * This section remains only to assist with understanding code that was
- * written to use these APIs at some point in the past.
- **/
-
 /**
  * GThreadPriority:
  * @G_THREAD_PRIORITY_LOW: a priority lower than normal