From 643014f8249196d4d7b45373d3b9b26cfa82e5cc Mon Sep 17 00:00:00 2001
From: Shriram Rajagopalan <shriram@us.ibm.com>
Date: Sun, 7 May 2017 22:36:41 -0400
Subject: [PATCH] cleaning up references into smaller sections

---
 .../reference/api/{ => mixer}/attribute-vocabulary.md |  2 +-
 _docs/reference/api/mixer/index.md                    | 11 +++++++++++
 _docs/reference/api/{ => mixer}/mixer-config.md       |  2 +-
 _docs/reference/api/{ => mixer}/mixer-service.md      |  2 +-
 .../api/{manager-config.md => service-mesh.md}        |  4 ++--
 .../api/{ => traffic-rules}/destination-policies.md   |  6 +++---
 _docs/reference/api/traffic-rules/index.md            | 11 +++++++++++
 .../api/{ => traffic-rules}/manager-swagger.json      |  0
 .../api/{ => traffic-rules}/routing-rules.md          |  6 +++---
 9 files changed, 33 insertions(+), 11 deletions(-)
 rename _docs/reference/api/{ => mixer}/attribute-vocabulary.md (99%)
 create mode 100644 _docs/reference/api/mixer/index.md
 rename _docs/reference/api/{ => mixer}/mixer-config.md (99%)
 rename _docs/reference/api/{ => mixer}/mixer-service.md (99%)
 rename _docs/reference/api/{manager-config.md => service-mesh.md} (99%)
 rename _docs/reference/api/{ => traffic-rules}/destination-policies.md (98%)
 create mode 100644 _docs/reference/api/traffic-rules/index.md
 rename _docs/reference/api/{ => traffic-rules}/manager-swagger.json (100%)
 rename _docs/reference/api/{ => traffic-rules}/routing-rules.md (99%)

diff --git a/_docs/reference/api/attribute-vocabulary.md b/_docs/reference/api/mixer/attribute-vocabulary.md
similarity index 99%
rename from _docs/reference/api/attribute-vocabulary.md
rename to _docs/reference/api/mixer/attribute-vocabulary.md
index 7d494de797..75cbdbb2c5 100644
--- a/_docs/reference/api/attribute-vocabulary.md
+++ b/_docs/reference/api/mixer/attribute-vocabulary.md
@@ -1,5 +1,5 @@
 ---
-title: Mixer - Attribute Vocabulary
+title: Attribute Vocabulary
 overview: Describes the base attribute vocabulary used for policy and control.
 
 order: 10
diff --git a/_docs/reference/api/mixer/index.md b/_docs/reference/api/mixer/index.md
new file mode 100644
index 0000000000..d40582f1d1
--- /dev/null
+++ b/_docs/reference/api/mixer/index.md
@@ -0,0 +1,11 @@
+---
+title: Mixer
+overview: Detailed information on configuration and API exposed by Mixer.
+
+order: 10
+
+layout: docs
+type: markdown
+---
+
+{% include section-index.html %}
diff --git a/_docs/reference/api/mixer-config.md b/_docs/reference/api/mixer/mixer-config.md
similarity index 99%
rename from _docs/reference/api/mixer-config.md
rename to _docs/reference/api/mixer/mixer-config.md
index b1ce337300..5da930c6a4 100644
--- a/_docs/reference/api/mixer-config.md
+++ b/_docs/reference/api/mixer/mixer-config.md
@@ -1,5 +1,5 @@
 ---
-title: Mixer - Configuration Schema
+title: Configuration Schema
 overview: Generated documentation for Mixer's configuration schema
 
 order: 40
diff --git a/_docs/reference/api/mixer-service.md b/_docs/reference/api/mixer/mixer-service.md
similarity index 99%
rename from _docs/reference/api/mixer-service.md
rename to _docs/reference/api/mixer/mixer-service.md
index 175043514d..a42429dc57 100644
--- a/_docs/reference/api/mixer-service.md
+++ b/_docs/reference/api/mixer/mixer-service.md
@@ -1,5 +1,5 @@
 ---
-title: Mixer - Southbound API
+title: API
 overview: Generated documentation for Mixer's API that is used by Envoy.
 
 order: 20
diff --git a/_docs/reference/api/manager-config.md b/_docs/reference/api/service-mesh.md
similarity index 99%
rename from _docs/reference/api/manager-config.md
rename to _docs/reference/api/service-mesh.md
index 4e57b781e4..51d013c23c 100644
--- a/_docs/reference/api/manager-config.md
+++ b/_docs/reference/api/service-mesh.md
@@ -1,8 +1,8 @@
 ---
-title: Service Mesh Configuration
+title: Service Mesh
 overview: Generated documentation for the Service Mesh global configuration.
 
-order: 5
+order: 30
 
 layout: docs
 type: markdown
diff --git a/_docs/reference/api/destination-policies.md b/_docs/reference/api/traffic-rules/destination-policies.md
similarity index 98%
rename from _docs/reference/api/destination-policies.md
rename to _docs/reference/api/traffic-rules/destination-policies.md
index a84ec37c9f..9de5aeea4b 100644
--- a/_docs/reference/api/destination-policies.md
+++ b/_docs/reference/api/traffic-rules/destination-policies.md
@@ -1,8 +1,8 @@
 ---
-title: Rules - Destination Policies
-overview: Generated documentation for the Istio's traffic management rules.
+title: Destination Policies
+overview: Generated documentation for Istio's client-side traffic management policies.
 
-order: 1000
+order: 30
 
 layout: docs
 type: markdown
diff --git a/_docs/reference/api/traffic-rules/index.md b/_docs/reference/api/traffic-rules/index.md
new file mode 100644
index 0000000000..3a7c9c3675
--- /dev/null
+++ b/_docs/reference/api/traffic-rules/index.md
@@ -0,0 +1,11 @@
+---
+title: Traffic Management Rules
+overview: Detailed information on rules configuration and API exposed by Istio-Manager for managing them.
+
+order: 10
+
+layout: docs
+type: markdown
+---
+
+{% include section-index.html %}
diff --git a/_docs/reference/api/manager-swagger.json b/_docs/reference/api/traffic-rules/manager-swagger.json
similarity index 100%
rename from _docs/reference/api/manager-swagger.json
rename to _docs/reference/api/traffic-rules/manager-swagger.json
diff --git a/_docs/reference/api/routing-rules.md b/_docs/reference/api/traffic-rules/routing-rules.md
similarity index 99%
rename from _docs/reference/api/routing-rules.md
rename to _docs/reference/api/traffic-rules/routing-rules.md
index 47916d925a..e825ce446a 100644
--- a/_docs/reference/api/routing-rules.md
+++ b/_docs/reference/api/traffic-rules/routing-rules.md
@@ -1,8 +1,8 @@
 ---
-title: Rules - Routing
-overview: Generated documentation for the Istio's traffic management rules
+title: Routing Rules
+overview: Generated documentation for Istio's traffic routing rules
 
-order: 990
+order: 20
 
 layout: docs
 type: markdown