cleaning up references into smaller sections

_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

_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 %}

_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

_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

_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

_docs/reference/api/traffic-rules/destination-policies.md

@@ -1,8 +1,8 @@
 ---
-title: Rules - Destination Policies
+title: Destination Policies
-overview: Generated documentation for the Istio's traffic management rules.
+overview: Generated documentation for Istio's client-side traffic management policies.
 
-order: 1000
+order: 30
 
 layout: docs
 type: markdown

_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 %}

_docs/reference/api/traffic-rules/routing-rules.md

@@ -1,8 +1,8 @@
 ---
-title: Rules - Routing
+title: Routing Rules
-overview: Generated documentation for the Istio's traffic management rules
+overview: Generated documentation for Istio's traffic routing rules
 
-order: 990
+order: 20
 
 layout: docs
 type: markdown