From ffa54929ea9f76692b25a50edbe238a3ba8decb5 Mon Sep 17 00:00:00 2001
From: Beth Wright <zbwright@gmail.com>
Date: Thu, 20 Jul 2017 11:05:05 -0700
Subject: [PATCH] docs: adding an index for upgrade pages.

---
 Documentation/docs.md                    | 13 ++-----------
 Documentation/upgrades/upgrading-etcd.md | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+), 11 deletions(-)
 create mode 100644 Documentation/upgrades/upgrading-etcd.md

diff --git a/Documentation/docs.md b/Documentation/docs.md
index 29550f3cf..0f9b6c1a4 100644
--- a/Documentation/docs.md
+++ b/Documentation/docs.md
@@ -58,14 +58,7 @@ Administrators who need a fault-tolerant etcd cluster for either development or
  - [Maintenance][maintenance]
  - [Failure modes][failures]
  - [Disaster recovery][recovery]
-
-### Upgrading and compatibility
-
- - [Version numbers][versioning]
- - [Migrate applications from using API v2 to API v3][v2_migration]
- - [Upgrading a v2.3 cluster to v3.0][v3_upgrade]
- - [Upgrading a v3.0 cluster to v3.1][v31_upgrade]
- - [Upgrading a v3.1 cluster to v3.2][v32_upgrade]
+ - [Upgrading][upgrading]
 
 ## Learning
 
@@ -115,9 +108,7 @@ To learn more about the concepts and internals behind etcd, read the following p
 [freebsd_platform]: platforms/freebsd.md
 [aws_platform]: platforms/aws.md
 [experimental]: dev-guide/experimental_apis.md
-[v3_upgrade]: upgrades/upgrade_3_0.md
-[v31_upgrade]: upgrades/upgrade_3_1.md
-[v32_upgrade]: upgrades/upgrade_3_2.md
 [authentication]: op-guide/authentication.md
 [auth_design]: learning/auth_design.md
 [tuning]: tuning.md
+[upgrading]: upgrades/upgrading-etcd.md
diff --git a/Documentation/upgrades/upgrading-etcd.md b/Documentation/upgrades/upgrading-etcd.md
new file mode 100644
index 000000000..8109151bd
--- /dev/null
+++ b/Documentation/upgrades/upgrading-etcd.md
@@ -0,0 +1,19 @@
+# Upgrading etcd clusters and applications
+
+This section contains documents specific to upgrading etcd clusters and applications.
+
+## Moving from etcd API v2 to API v3
+* [Migrate applications from using API v2 to API v3][migrate-apps]
+
+## Upgrading an etcd v3.x cluster
+* [Upgrade etcd from 3.0 to 3.1][upgrade-3-1]
+* [Upgrade etcd from 3.1 to 3.2][upgrade-3-2]
+
+## Upgrading from etcd v2.3
+* [Upgrade a v2.3 cluster to v3.0][upgrade-cluster]
+
+
+[migrate-apps]: ../op-guide/v2-migration.md
+[upgrade-cluster]: upgrade_3_0.md
+[upgrade-3-1]: upgrade_3_1.md
+[upgrade-3-2]: upgrade_3_2.md