Merge pull request #2866 into main.

1 files changed, 21 insertions, 0 deletions

diff --git a/docs/deprecated/index.rst b/docs/deprecated/index.rst
new file mode 100644
index 00000000..ce2ac006
--- /dev/null
+++ b/docs/deprecated/index.rst
@@ -0,0 +1,21 @@
+======================================================
+Guides on backward compatibility & deprecated practice
+======================================================
+
+``Setuptools`` has undergone tremendous changes since its first debut. As its
+development continues to roll forward, many of the practice and mechanisms it
+had established are now considered deprecated. But they still remain relevant
+as a plethora of libraries continue to depend on them. Many people also find
+it necessary to equip themselves with the knowledge to better support backward
+compatibility. This guide aims to provide the essential information for such
+objectives.
+
+.. toctree::
+    :maxdepth: 1
+
+    python3
+    python_eggs
+    easy_install
+    distutils/index
+    distutils-legacy
+    functionalities