Merge pull request #2097 from alvyjudy/improve-doc

doc overhaul step 1: simplify index and group deprecated files

5 files changed, 23 insertions, 8 deletions

diff --git a/docs/easy_install.txt b/docs/deprecated/easy_install.txt
index fac7b8fc..fac7b8fc 100644
--- a/docs/easy_install.txt
+++ b/docs/deprecated/easy_install.txt
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
+
diff --git a/docs/python3.txt b/docs/deprecated/python3.txt
index 6b55fe78..6b55fe78 100644
--- a/docs/python3.txt
+++ b/docs/deprecated/python3.txt
diff --git a/docs/formats.txt b/docs/deprecated/python_eggs.txt
index 6c0456de..6c0456de 100644
--- a/docs/formats.txt
+++ b/docs/deprecated/python_eggs.txt
diff --git a/docs/index.txt b/docs/index.txt
index 13a46e74..38fbbcc5 100644
--- a/docs/index.txt
+++ b/docs/index.txt
@@ -14,12 +14,8 @@ designed to facilitate packaging Python projects, where packaging includes:
 Documentation content:
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   setuptools
-   pkg_resources
-   python3
-   development
-   roadmap
-   Deprecated: Easy Install <easy_install>
-   history
+   User guide <setuptools>
+   Development guide <development>
+   Backward compatibility & deprecated practice <deprecated/index>