diff --git a/_docs/concepts/architecture.md b/_docs/concepts/architecture.md index 2dd7aac664..9040183c07 100644 --- a/_docs/concepts/architecture.md +++ b/_docs/concepts/architecture.md @@ -1,7 +1,8 @@ --- category: Concepts title: Architecture - +overview: Highlights Istio's core architectural structure and components. + parent: What is Istio? order: 30 diff --git a/_docs/concepts/attributes.md b/_docs/concepts/attributes.md index 6403d15473..01505d9254 100644 --- a/_docs/concepts/attributes.md +++ b/_docs/concepts/attributes.md @@ -1,7 +1,8 @@ --- category: Concepts title: Attributes - +overview: Explains the important notion of attributes, which is a central mechanism for how policies and control are applied to services within the mesh. + parent: Policies and Control order: 10 diff --git a/_docs/concepts/fault-injection.md b/_docs/concepts/fault-injection.md index 56ceb418c4..cde72dd393 100644 --- a/_docs/concepts/fault-injection.md +++ b/_docs/concepts/fault-injection.md @@ -1,7 +1,8 @@ --- category: Concepts title: Fault Injection - +overview: Introduces the idea of systematic fault injection that can be used to unconver conflicting failure recovery policies across services. + parent: Traffic Management order: 40 diff --git a/_docs/concepts/goals.md b/_docs/concepts/goals.md index 674074dd84..681d95fe5f 100644 --- a/_docs/concepts/goals.md +++ b/_docs/concepts/goals.md @@ -1,7 +1,8 @@ --- category: Concepts title: Design Goals - +overview: Describes the core principles that Istio's design adheres to. + parent: What is Istio? order: 20 diff --git a/_docs/concepts/handling-failures.md b/_docs/concepts/handling-failures.md index 639cbccb91..1813b114fd 100644 --- a/_docs/concepts/handling-failures.md +++ b/_docs/concepts/handling-failures.md @@ -1,7 +1,8 @@ --- category: Concepts title: Handling Failures - +overview: An overview of failure recovery capabilities in Envoy that can be leveraged by unmodified applications to improve robustness and prevent cascading failures. + parent: Traffic Management order: 30 diff --git a/_docs/concepts/index.md b/_docs/concepts/index.md index 87597fa153..a6def7891b 100644 --- a/_docs/concepts/index.md +++ b/_docs/concepts/index.md @@ -16,51 +16,4 @@ type: markdown Concepts help you learn about the different parts of the Istio system and the abstractions it uses. -- What Is Istio? - - - [Overview](./overview.html). Provides a broad overview of what -problems Istio is designed to solve. - - - [Design Goals](./goals.html). Describes the core principles that - Istio's design adheres to. - - - [Architecture](./architecture.html). Highlights Istio's core - architectural structure and components. - -- Traffic Management - - - [Overview](./traffic-management-overview.html). Provides a conceptual overview of - traffic management principles in Istio and the kind of features - enabled by these principles. - - - [Istio-Manager](./manager.html). Introduces the Istio-Manager, the - component responsible for managing a distributed deployment of Envoy - proxies in the service mesh. - - - [Service Model](./service-model.html). Describes how services are - modeled within the Istio mesh, the notion of multiple versions of a - service, and the communiction model between services. - - - [Handling Failures](./handling-failures.html). An overview of failure - recovery capabilities in Envoy that can be leveraged by unmodified - applications to improve robustness and prevent cascading failures. - - - [Fault Injection](./fault-injection.html). Introduces the idea of - systematic fault injection that can be used to unconver conflicting - failure recovery policies across services. - - - [Rules Configuration](./rules-configuration.html). Provides a high-level - overview of the domain-specific language used by Istio to configure - traffic management rules in the service mesh. - -- Policies and Control - - - [Attributes](./attributes.html). Explains the important notion of attributes, which - is a central mechanism for how policies and control are applied to services within the - mesh. - - - [Mixer](./mixer.html). Architectural deep-dive into the design of Mixer, which provides - the policy and control mechanisms within the service mesh. - - - [Mixer Configuration](./mixer-config.html). An overview of the key concepts used to configure - Mixer. +{% include section-index.html %} diff --git a/_docs/concepts/manager.md b/_docs/concepts/manager.md index cf84adf951..fff7656cfe 100644 --- a/_docs/concepts/manager.md +++ b/_docs/concepts/manager.md @@ -1,7 +1,8 @@ --- category: Concepts title: Istio-Manager - +overview: Introduces the Istio-Manager, the component responsible for managing a distributed deployment of Envoy proxies in the service mesh. + parent: Traffic Management order: 10 diff --git a/_docs/concepts/mixer-config.md b/_docs/concepts/mixer-config.md index a770542984..bd81b6bafb 100644 --- a/_docs/concepts/mixer-config.md +++ b/_docs/concepts/mixer-config.md @@ -1,7 +1,8 @@ --- category: Concepts title: Mixer Configuration - +overview: An overview of the key concepts used to configure Mixer. + parent: Policies and Control order: 30 diff --git a/_docs/concepts/mixer.md b/_docs/concepts/mixer.md index bb67e632eb..e5f1c4de7b 100644 --- a/_docs/concepts/mixer.md +++ b/_docs/concepts/mixer.md @@ -1,7 +1,8 @@ --- category: Concepts title: Mixer - +overview: Architectural deep-dive into the design of Mixer, which provides the policy and control mechanisms within the service mesh. + parent: Policies and Control order: 20 diff --git a/_docs/concepts/overview.md b/_docs/concepts/overview.md index ec98e3f66f..b9f9a42d5a 100644 --- a/_docs/concepts/overview.md +++ b/_docs/concepts/overview.md @@ -1,7 +1,8 @@ --- category: Concepts title: Overview - +overview: Provides a broad overview of what problems Istio is designed to solve. + parent: What is Istio? order: 15 diff --git a/_docs/concepts/rules-configuration.md b/_docs/concepts/rules-configuration.md index 014d2e1da9..fdeea8ea87 100644 --- a/_docs/concepts/rules-configuration.md +++ b/_docs/concepts/rules-configuration.md @@ -1,7 +1,8 @@ --- category: Concepts title: Rules Configuration - +overview: Provides a high-level overview of the domain-specific language used by Istio to configure traffic management rules in the service mesh. + parent: Traffic Management order: 50 diff --git a/_docs/concepts/service-model.md b/_docs/concepts/service-model.md index 3368584ae6..6bf0a309ec 100644 --- a/_docs/concepts/service-model.md +++ b/_docs/concepts/service-model.md @@ -1,7 +1,8 @@ --- category: Concepts title: Service Model - +overview: Describes how services are modeled within the Istio mesh, the notion of multiple versions of a service, and the communication model between services. + parent: Traffic Management order: 20 diff --git a/_docs/concepts/traffic-management-overview.md b/_docs/concepts/traffic-management-overview.md index 3693e504aa..8dceb9b779 100644 --- a/_docs/concepts/traffic-management-overview.md +++ b/_docs/concepts/traffic-management-overview.md @@ -1,7 +1,8 @@ --- category: Concepts title: Overview - +overview: Provides a conceptual overview of traffic management principles in Istio and the kind of features enabled by these principles. + parent: Traffic Management order: 0 diff --git a/_includes/section-index.html b/_includes/section-index.html new file mode 100644 index 0000000000..950171dcda --- /dev/null +++ b/_includes/section-index.html @@ -0,0 +1,29 @@ +