From f2ab7e3f6cf3b6a66e0f0e0a604e255d1f52442f Mon Sep 17 00:00:00 2001
From: yahya-mhf <68018817+yahya-mhf@users.noreply.github.com>
Date: Tue, 2 Dec 2025 11:07:15 +0100
Subject: [PATCH] Add documentation for self-referential extras (#11296)

---
 docs/html/topics/self-referential-extras.md | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 docs/html/topics/self-referential-extras.md

diff --git a/docs/html/topics/self-referential-extras.md b/docs/html/topics/self-referential-extras.md
new file mode 100644
index 00000000000..a03f7db2225
--- /dev/null
+++ b/docs/html/topics/self-referential-extras.md
@@ -0,0 +1,11 @@
+# Self-referential extras
+
+pip supports declaring optional dependencies that reference other optional dependencies of the same project.
+
+Example:
+
+```toml
+[project.optional-dependencies]
+all = ["pkg[a]", "pkg[b]"]
+a = ["dependencyA"]
+b = ["dependencyB"]