docs: added index for deprecated files

1 files changed, 19 insertions, 0 deletions

diff --git a/docs/deprecated/index.txt b/docs/deprecated/index.txt
new file mode 100644
index 00000000..bb6579f8
--- /dev/null
+++ b/docs/deprecated/index.txt
@@ -0,0 +1,19 @@
+======================================================
+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
+