From c23ab4259edd13b848c3553974092d83f15f44f1 Mon Sep 17 00:00:00 2001
From: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
Date: Wed, 15 Jun 2022 14:01:34 -0500
Subject: [PATCH] Apply suggestions from code review

Co-authored-by: Blake Covarrubias <blake@covarrubi.as>
Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
---
 .../connect/cluster-peering/create-manage-peering.mdx | 11 +++++------
 .../content/docs/connect/cluster-peering/index.mdx    |  2 +-
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/website/content/docs/connect/cluster-peering/create-manage-peering.mdx b/website/content/docs/connect/cluster-peering/create-manage-peering.mdx
index 5b1e43b6d..9d5e794f7 100644
--- a/website/content/docs/connect/cluster-peering/create-manage-peering.mdx
+++ b/website/content/docs/connect/cluster-peering/create-manage-peering.mdx
@@ -59,7 +59,7 @@ When you connect server agents through cluster peering, they will peer their def
 
 ## Connect service endpoints
 
-After you establish a connection between the clusters, you need to create a configuration entry that defines the services that are available for other clusters. Consul uses this configuration entry to replicate service definitions and support service mesh connections across clusters.
+After you establish a connection between the clusters, you need to create a configuration entry that defines the services that are available for other clusters. Consul uses this configuration entry to advertise service information and support service mesh connections across clusters.
 
 First, create a configuration entry and specify the `Kind` as `“exported-services”`.
 
@@ -105,7 +105,6 @@ First, create a configuration entry and specify the `Kind` as `“service-intent
 ```hcl
 Kind      = "service-intentions"
 Name      = "frontend-service"
-Partition = "partition-name"
 
 Sources = [
   {
@@ -128,14 +127,14 @@ $ consul config write peering-intentions.hcl
 
 ## Check peered cluster status
 
-To confirm that you peered your clusters, you can [query the `/health/service` endpoint](https://www.consul.io/api-docs/health) of one cluster from the other cluster. For example, in "cluster-02," query the endpoint and add the `peer=cluster-01` parameter to the end of the URL.
+To confirm that you peered your clusters, you can [query the `/health/service` endpoint](/api-docs/health) of one cluster from the other cluster. For example, in "cluster-02," query the endpoint and add the `peer=cluster-01` query parameter to the end of the URL.
 
 ```shell-session
 $ curl \
-    http://127.0.0.1:8500/v1/health/service/service-name?peer=cluster-01
+    "http://127.0.0.1:8500/v1/health/service/service-name?peer=cluster-01"
 ```
 
-Successful connections include service definitions in the output.
+A successful query will include service information in the output.
 
 ## Remove peering connections
 
@@ -144,5 +143,5 @@ After you create a peering connection between clusters in different datacenters,
 In “cluster-01,” request the deletion via the HTTP API.
 
 ```shell-session
-$ curl -X DELETE http://127.0.0.1:8500/v1/peering/cluster-02
+$ curl --request DELETE http://127.0.0.1:8500/v1/peering/cluster-02
 ```
diff --git a/website/content/docs/connect/cluster-peering/index.mdx b/website/content/docs/connect/cluster-peering/index.mdx
index 51f1f916a..af93e05d0 100644
--- a/website/content/docs/connect/cluster-peering/index.mdx
+++ b/website/content/docs/connect/cluster-peering/index.mdx
@@ -7,7 +7,7 @@ description: >-
 
 # What is Cluster Peering?
 
-~> This page covers features that are currently in _technical preview_. Features and functionality are subject to change. You should never use the technical preview release in secure environments or production scenarios. Features in technical preview may face performance and scaling issues, with limited support options available.
+->**Cluster peering is currently in technical preview**: Functionality associated with cluster peering is subject to change. You should never use the technical preview release in secure environments or production scenarios. Features in technical preview may have performance issues, scaling issues, and limited support.
 
 Cluster peering is a Consul feature to allow service connectivity between two independent clusters. Similar to WAN Federation, you can use cluster peering to enable service connectivity between partitions in different datacenters.