From 75e2324c7321df955bd877a860ee9754f77f1b83 Mon Sep 17 00:00:00 2001
From: Lars Wander <lwander@users.noreply.github.com>
Date: Fri, 12 May 2017 14:41:57 -0400
Subject: [PATCH] feat(reference): Fill out reference page index (#98)

---
 _data/navigation.yml         |  2 ++
 reference/index.md           |  4 +++-
 reference/providers/index.md | 23 +++++++++++++++++++++--
 3 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/_data/navigation.yml b/_data/navigation.yml
index 5e7cf62c7d..c766fa2f86 100644
--- a/_data/navigation.yml
+++ b/_data/navigation.yml
@@ -148,6 +148,8 @@ reference:
       url: /reference/api/swagger-ui/
   - title: Cloud Providers
     children:
+      - title: Overview
+        url: /reference/providers/
       - title: Amazon Web Services
         url: /reference/providers/aws/
       - title: Azure
diff --git a/reference/index.md b/reference/index.md
index 3695ba1fe9..47b6495cd5 100644
--- a/reference/index.md
+++ b/reference/index.md
@@ -5,4 +5,6 @@ sidebar:
   nav: reference
 ---
 
-{% include toc %}
+Welcome to the Spinnaker Reference pages. These pages are intended
+for advanced Spinnaker users and developers looking for detailed explanations
+of how the various parts of Spinnaker work and fit together.
diff --git a/reference/providers/index.md b/reference/providers/index.md
index 88a307ce18..74781cd615 100644
--- a/reference/providers/index.md
+++ b/reference/providers/index.md
@@ -1,8 +1,27 @@
 ---
 layout: single
-title:  "Cloud Providers"
+title:  "Overview"
 sidebar:
   nav: reference
 ---
 
-links to providers
+{% include toc %}
+
+Once you're familar with the definition and setup of a [Cloud
+Provider](/setup/providers/), you can read these reference pages for
+information on how Spinnaker concepts map to those of the Cloud Provider, as
+well as how the various Spinnaker operations are performed at the Cloud
+Provider level. 
+
+## Supported Providers
+
+These are the Cloud Providers currently supported by Spinnaker:
+
+* [App Engine](/reference/providers/)
+* [Amazon Web Services](/reference/providers/)
+* [Azure](/reference/providers/azure/)
+* [Google Compute Engine](/reference/providers/gce/)
+* [Kubernetes](/reference/providers/kubernetes/)
+* [Openstack](/reference/providers/openstack/)
+* [Oracle](/reference/providers/oracle/)
+* [Titus](/reference/providers/titus/)