Some cleanup and clarifications (#5663)

content/en/docs/examples/microservices-istio/_index.md

@@ -1,7 +1,7 @@
 ---
-title: Learn Microservices using Kubernetes and Istio 
+title: Learn Microservices using Kubernetes and Istio
 description: This modular tutorial provides new users with hands-on experience using Istio for common microservices scenarios, one step at a time.   
-weight: 40
+weight: 100
 icon: classroom
 simple_list: true
 content_above: true

content/en/docs/examples/multicluster/_index.md

@@ -1,8 +0,0 @@
----
-title: Multicluster Service Mesh
-description: Multicluster service mesh examples for Istio that you can experiment with.
-weight: 100
-keywords: [multicluster]
----
-Refer to the [multicluster service mesh](/docs/setup/deployment-models/) concept documentation
-for more information.

content/en/docs/examples/platform/_index.md

@@ -0,0 +1,10 @@
+---
+title: Platform-specific Examples (Deprecated)
+description: Examples for specific platform installations of Istio.
+weight: 110
+keywords: [multicluster]
+---
+
+{{< warning >}}
+These examples are platform-specific and deprecated. They will be removed in the next release.
+{{< /warning >}}

content/en/docs/examples/platform/endpoints/index.md

@@ -1,9 +1,10 @@
 ---
 title: Install Istio for Google Cloud Endpoints Services
 description: Explains how to manually integrate Google Cloud Endpoints services with Istio.
-weight: 42
+weight: 10
 aliases:
     - /docs/guides/endpoints/index.html
+    - /docs/examples/endpoints/
 ---
 
 This document shows how to manually integrate Istio with existing

content/en/docs/examples/platform/gke/index.md

@@ -5,6 +5,7 @@ weight: 65
 keywords: [kubernetes,multicluster]
 aliases:
   - /docs/tasks/multicluster/gke/
+  - /docs/examples/multicluster/gke/
 ---
 
 This example shows how to configure a multicluster mesh with a

content/en/docs/examples/platform/icp/index.md

@@ -5,6 +5,7 @@ weight: 70
 keywords: [kubernetes,multicluster]
 aliases:
     - /docs/tasks/multicluster/icp/
+    - /docs/examples/multicluster/icp/
 ---
 
 This example demonstrates how to setup network connectivity between two

content/en/docs/examples/virtual-machines/_index.md

@@ -1,8 +1,7 @@
 ---
 title: Virtual Machines
-description: Learn how to add workloads running on virtual machines or bare metal
-  to your Istio mesh.
-weight: 90
+description: Examples that add workloads running on virtual machines to an Istio mesh.
+weight: 30
 aliases:
 - /docs/examples/mesh-expansion/
 - /docs/examples/mesh-expansion
@@ -12,4 +11,3 @@ keywords:
 - vms
 - virtual-machine
 ---
-

content/en/docs/setup/getting-started/index.md

@@ -5,14 +5,13 @@ weight: 5
 aliases:
     - /docs/setup/kubernetes/getting-started/
     - /docs/setup/kubernetes/
-skip_toc: true
 keywords: [getting-started, install, bookinfo, quick-start, kubernetes]
 ---
 
 To get started with Istio, just follow these three steps:
 
 1. [Set up your platform](#platform)
-1. [Download the Istio release](#download)
+1. [Download the release](#download)
 1. [Install Istio](#install)
 
 ## Set up your platform {#platform}
@@ -27,7 +26,7 @@ installing Istio manually. If this is the case with your selected platform, and
 you will be finished installing Istio after creating the cluster, so you can skip the following instructions.
 Refer to your platform service provider for further details and instructions.
 
-## Download the Istio release {#download}
+## Download the release {#download}
 
 Download the Istio release which includes installation files, samples, and the
 [{{< istioctl >}}](/docs/reference/commands/istioctl/) command line utility.
@@ -183,12 +182,10 @@ The following tasks are a good place for beginners to start:
 - [Accessing external services](/docs/tasks/traffic-management/egress/egress-control/)
 - [Visualizing your mesh](/docs/tasks/observability/kiali/)
 
-The tasks above provide a good basic understanding of Istio's features but,
-explore more [tasks](/docs/tasks/) depending on what interests you. Before you
-install and customize Istio to fit your platform and intended use, check out
-our [general installation instructions](/docs/setup/) for details.
-
-The next step is to deploy your own applications.
+The next step is to customize Istio and deploy your own applications.
+Before you install and customize Istio to fit your platform and intended use, check out
+our [deployment models](/docs/setup/deployment-models/) and [general installation](/docs/setup/)
+documents.
 
 As you continue to use Istio, we look forward to hearing from you and welcoming
 you to our [community](/about/community/join/).