hashicorp
diff --git a/‎website/content/docs/connect/cluster-peering/index.mdx‎
Lines changed: 8 additions & 5 deletions b/‎website/content/docs/connect/cluster-peering/index.mdx‎
Lines changed: 8 additions & 5 deletions
diff --git a/‎…peering/usage/create-cluster-peering.mdx‎ ‎…ring/usage/establish-cluster-peering.mdx‎website/content/docs/connect/cluster-peering/usage/create-cluster-peering.mdx renamed to website/content/docs/connect/cluster-peering/usage/establish-cluster-peering.mdx
Lines changed: 1 addition & 1 deletion b/‎…peering/usage/create-cluster-peering.mdx‎ ‎…ring/usage/establish-cluster-peering.mdx‎website/content/docs/connect/cluster-peering/usage/create-cluster-peering.mdx renamed to website/content/docs/connect/cluster-peering/usage/establish-cluster-peering.mdx
Lines changed: 1 addition & 1 deletion
diff --git a/‎website/content/docs/connect/cluster-peering/usage/k8s.mdx‎
Lines changed: 0 additions & 231 deletions b/‎website/content/docs/connect/cluster-peering/usage/k8s.mdx‎
Lines changed: 0 additions & 231 deletions
diff --git a/‎website/content/docs/connect/cluster-peering/usage/peering-traffic-management.mdx‎
Lines changed: 1 addition & 1 deletion b/‎website/content/docs/connect/cluster-peering/usage/peering-traffic-management.mdx‎
Lines changed: 1 addition & 1 deletion
@@ -47,9 +47,9 @@ Regardless of whether you connect your clusters through WAN federation or cluste
 | Shares key/value stores                            |    &#9989;     |    &#10060;     |
 | Can replicate ACL tokens, policies, and roles      |    &#9989;     |    &#10060;     |
 
-## Topic contents
+## Guidance
 
-The following resources are available to help you get started with and use Consul's cluster peering features.
+The following resources are available to help you use Consul's cluster peering features.
 
 **Tutorials:**
 
@@ -59,17 +59,20 @@ The following resources are available to help you get started with and use Consu
 
 - [Establish cluster peering connections](/consul/docs/connect/cluster-peering/usage/establish-peering)
 - [Manage cluster peering connections](/consul/docs/connect/cluster-peering/usage/manage-connections)
-- [L7 traffic management for cluster peering connections](/consul/docs/connect/cluster-peering/usage/peering-traffic-management)
+- [Manage L7 traffic with cluster peering](/consul/docs/connect/cluster-peering/usage/peering-traffic-management)
 
 **Runtime-specific information:**
 
-- [Cluster peering on Kubernetes](/consul/docs/connect/cluster-peering/usage/k8s)
+- [Cluster peering on Kubernetes technical specifications](/consul/docs/k8s/connect/cluster-peering/k8s-tech-specs)
+- [Establish cluster peering connections on Kubernetes](/consul/docs/k8s/connect/cluster-peering/usage/k8s-establish-peering)
+- [Manage cluster peering connections on Kubernetes](/consul/docs/k8s/connect/cluster-peering/usage/k8s-manage-peering)
+- [Manage L7 traffic with cluster peering on Kubernetes](/consul/docs/k8s/connect/cluster-peering/usage/k8s-l7-traffic)
 
 **Reference information:**
 
+- [Cluster peering technical specifications](/consul/docs/connect/cluster-peering/tech-specs)
 - [HTTP API reference: `/peering/` endpoint](/consul/api-docs/peering)
 - [CLI reference: `peering` command](/consul/commands/peering).
-- [Cluster peering technical specifications](/consul/docs/connect/cluster-peering/tech-specs)
 
 ## Basic troubleshooting
 
 
@@ -2,7 +2,7 @@
 layout: docs
 page_title: Establish Cluster Peering Connections
 description: >-
-  Generate a peering token to establish communication, export services, and authorize requests for cluster peering connections. Learn how to create, list, read, check, and delete peering connections.
+  Generate a peering token to establish communication, export services, and authorize requests for cluster peering connections. Learn how to establish peering connections with Consul's HTTP API, CLI or UI.
 ---
 
 # Establish cluster peering connections
 
@@ -5,7 +5,7 @@ description: >-
   Combine service resolver configurations with splitter and router configurations to manage L7 traffic in Consul deployments with cluster peering connections. Learn how to define dynamic traffic rules to target peers for redirects and failover. 
 ---
 
-# L7 traffic management for cluster peering
+# Manage L7 traffic with cluster peering
 
 This usage topic describes how to configure and apply the [`service-resolver` configuration entry](/docs/connect/config-entries/) to set up redirects and failovers between services that have an existing cluster peering connection.