fix according to the preview

shiyuhang0 · shiyuhang0 · commit 94b06afe4a8c · 2025-12-17T12:33:45.000+08:00
diff --git a/tidb-cloud/serverless-private-link-connection-to-alicloud-rds.md b/tidb-cloud/serverless-private-link-connection-to-alicloud-rds.md
@@ -11,20 +11,20 @@ This document describes how to connect to an Alibaba Cloud RDS instance using an
     - Manage load balancer
     - Manage endpoint services
 
-3. Ensure your {{.essential}} in alibaba cloud provider and get its account ID and available zones, save the information for later use.
+3. Ensure your {{{ .essential }}} in alibaba cloud provider and get its account ID and available zones, save the information for later use.
 
     1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the cluster overview page of the TiDB cluster, and then click **Settings** > **Networking** in the left navigation pane.
     2. On the **Private Link Connection For Dataflow**, click **Create Private Link Connection**.
-    3. You can find the AWS account ID and available zones information.
+    3. You can find the Alibaba Cloud account ID and available zones information.
 
 ## Step 1. Set up an RDS instance
 
 Identify an Alibaba Cloud ApsaraDB RDS you want to use, or [set up a new RDS](https://www.alibabacloud.com/help/en/rds/apsaradb-rds-for-mysql/step-1-create-an-apsaradb-rds-for-mysql-instance-and-configure-databases).
 
 The RDS must meet the following requirements:
 
-- The Alibaba Cloud region for your RDS instance must be the same as the region for your {{.essential}}.
-- The subnet group of your RDS must have overlapping availability zones as your {{.essential}}.
+- The Alibaba Cloud region for your RDS instance must be the same as the region for your {{{ .essential }}}.
+- The subnet group of your RDS must have overlapping availability zones as your {{{ .essential }}}.
 - Make sure your RDS instance set proper IP whitelist and is accessible within the VPC.
 
 > **Note**
@@ -49,7 +49,7 @@ Set up the load balancer in the same region of your RDS:
 
     - **Network Type**: `Internal-facing`
     - **VPC**: The VPC where your RDS is located
-    - **Zone**: Must have overlapping availability zones with your {{.essential}}
+    - **Zone**: Must have overlapping availability zones with your {{{ .essential }}}
     - **IP Version**: `IPv4`
 
     Find the load balancer you created, and then click **Create Listerner**:
diff --git a/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md b/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md
@@ -10,7 +10,7 @@ This document describes how to connect to an AWS Confluent Dedicated Cluster usi
    
 1. You have a Confluent Cloud account.
 
-2. Get the {{.essential}} account ID and available zones, save the information for later use.
+2. Ensure your {{{ .essential }}} in aws provider and get the {{{ .essential }}} account ID and available zones, save the information for later use.
 
     1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the cluster overview page of the TiDB cluster, and then click **Settings** > **Networking** in the left navigation pane.
     2. On the **Private Link Connection For Dataflow**, click **Create Private Link Connection**.
@@ -22,16 +22,16 @@ Identify a Confluent Cloud network you want to use, or [set up a new Confluent C
 
 The Confluent Cloud network must meet the following requirements:
 
-- The network must be in the same AWS region as your {{.essential}}.
-- The network must have overlapping availability zones as your {{.essential}}, recommended to have same availability zones.
+- The network must be in the same AWS region as your {{{ .essential }}}.
+- The network must have overlapping availability zones as your {{{ .essential }}}, recommended to have same availability zones.
 
 On the `Network overview` page, obtain the `DNS subdomain` of the Confluent Cloud network. You need to extract the unique name from it.
 For example, if the `DNS subdomain` is `use1-az1.domnprzqrog.us-east-1.aws.confluent.cloud`, then the unique name is `domnprzqrog.us-east-1`.
 Please save the unique name for later use.
 
 > **Note**
 >
-> The Confluent Cloud Dedicated cluster you want TiDB Cloud to connect to must be under this network.
+> The Confluent Cloud Dedicated cluster you want TiDB Cloud to connect to must under this network.
 
 ## Step 2. Add a PrivateLink Access to the network
 
@@ -80,7 +80,7 @@ ticloud serverless private-link-connection create -c <cluster-id> --display-name
 </div>
 </SimpleTab>
 
-### Attach domains to the private link connection
+### 2. Attach domains to the private link connection
 
 You will need the unique name you obtained in Step 1.
 
diff --git a/tidb-cloud/serverless-private-link-connection-to-aws-rds.md b/tidb-cloud/serverless-private-link-connection-to-aws-rds.md
@@ -12,7 +12,7 @@ This document describes how to connect to an AWS RDS instance using an AWS Endpo
     - Manage load balancer
     - Manage endpoint services
 
-3. Get the {{.essential}} account ID and available zones, save the information for later use.
+3. Ensure your {{{ .essential }}} in aws provider and get the {{{ .essential }}} account ID and available zones, save the information for later use.
 
     1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the cluster overview page of the TiDB cluster, and then click **Settings** > **Networking** in the left navigation pane.
     2. On the **Private Link Connection For Dataflow**, Click **Create Private Link Connection**.
@@ -24,8 +24,8 @@ Identify an AWS RDS instance to use, or [set up a new one](https://docs.aws.amaz
 
 The RDS must meet the following requirements:
 
-- The RDS must be in the same AWS region as your {{.essential}}.
-- The subnet group of your RDS must have overlapping availability zones as your {{.essential}}.
+- The RDS must be in the same AWS region as your {{{ .essential }}}.
+- The subnet group of your RDS must have overlapping availability zones as your {{{ .essential }}}.
 - Make sure your RDS instance set proper security group and is accessible within the VPC.
 
 > **Note**
@@ -53,7 +53,7 @@ Set up the load balancer in the same region of your RDS:
     - **Schema**: `Internal`
     - **Load balancer IP address type**: `IPv4`
     - **VPC**: The VPC where your RDS is located
-    - **Availability Zones**: Must have overlapping availability zones with your {{.essential}}
+    - **Availability Zones**: Must have overlapping availability zones with your {{{ .essential }}}
     - **Security groups**: Create a new security group with the following rules.
         - Inbound rule allows MySQL/Aurora: Type - `MySQL/Aurora`; Source - `Anywhere-IPv4`.
         - Outbound rule allows all TCP: Type - `All TCP`; Destination - `Anywhere-IPv4`
diff --git a/tidb-cloud/serverless-private-link-connection-to-self-hosted-kafka-in-aws.md b/tidb-cloud/serverless-private-link-connection-to-self-hosted-kafka-in-aws.md
@@ -23,7 +23,7 @@ The mechanism works as follows:
     - Manage load balancer
     - Manage endpoint services
 
-3. Get the {{.essential}} account ID and available zones, save the information for later use.
+3. Ensure your {{{ .essential }}} in aws provider and get the {{{ .essential }}} account ID and available zones, save the information for later use.
 
     1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the cluster overview page of the TiDB cluster, and then click **Settings** > **Networking** in the left navigation pane.
     2. On the **Private Link Connection For Dataflow**, click **Create Private Link Connection**.
@@ -744,7 +744,7 @@ ticloud serverless private-link-connection create -c <cluster-id> --display-name
 </div>
 </SimpleTab>
 
-### Attach Domains to the Private Link Connection
+### 2. Attach Domains to the Private Link Connection
 
 You can also refer to [Attach Domains to a Private Link Connection](/tidbcloud/serverless-private-link-connection#attach-domains-to-a-private-link-connection) for more details.
 
@@ -763,7 +763,7 @@ You can also refer to [Attach Domains to a Private Link Connection](/tidbcloud/s
 
 4. Click **Attach Domains**.
 
-5. In the **Attach Domains** dialog, select the **TiDB Cloud Managed** domain type. The domains will be auto-generated by TiDB Cloud. Copy the unique name for later use and click **Attach Domains** to confirm.
+5. In the **Attach Domains** dialog, select the **TiDB Cloud Managed** domain type. The domains will be auto-generated by TiDB Cloud. Copy the unique name for later use and click **Attach Domains** to confirm. For example, if the generated domain is `*.use1-az1.dvs6nl5jgveztmla3pxkxgh76i.aws.plc.tidbcloud.com`, then the unique name is `dvs6nl5jgveztmla3pxkxgh76i`.
 
 </div>
 
@@ -786,5 +786,5 @@ ticloud serverless private-link-connection attach-domains -c <cluster-id> --priv
 
 ## Step 4. Replace the Unique Name placeholder in Kafka configuration
 
-1. Go back to your Kafka broker nodes, and replace the `unique_name` placeholder of each broker with the actual unique name you get from the previous step.
+1. Go back to your Kafka broker nodes, replace the `unique_name` placeholder in `advertised.listeners` configuration of each broker with the actual unique name you get from the previous step.
 2. After you reconfigure all the brokers, restart your Kafka brokers one by one.
diff --git a/tidb-cloud/serverless-private-link-connection.md b/tidb-cloud/serverless-private-link-connection.md
@@ -12,19 +12,19 @@ The Private Link Connection enables private, direct connectivity between {{{ .es
 
 This type of private link connection enables TiDB Cloud clusters on **AWS** to connect to your [AWS endpoint service](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html) powered by AWS PrivateLink.
 
-The Private Link Connection can access various AWS services by attach them to the endpoint service, including RDS instances and Kafka services, over a private network.
+The Private Link Connection can access various AWS services by associating them to the endpoint service, such as RDS instances and Kafka services.
 
 ### AliCloud Endpoint Service
 
-This type of private link connection enables TiDB Cloud clusters on **Alibaba Cloud** to connect to your [Alibaba Cloud endpoint service](https://www.alibabacloud.com/help/en/privatelink/share-your-service/) powered by Alibaba Cloud PrivateLink.
+This type of private link connection enables TiDB Cloud clusters on **Alibaba Cloud** to connect to your [Alibaba Cloud endpoint service](https://www.alibabacloud.com/help/en/privatelink/share-your-service/#51976edba8no7) powered by Alibaba Cloud PrivateLink.
 
-The Private Link Connection can access various Alibaba Cloud services by attaching them to the endpoint service, including RDS instances and Kafka services, over a private network.
+The Private Link Connection can access various Alibaba Cloud services by associating them to the endpoint service, such as RDS instances and Kafka services.
 
 ## Attach Domains
 
 You can attach domains to a private link connection. 
 
-When a domain is attached to the Private Link Connection, all traffic to this domain will be routed to this private link connection. It is useful when your service provides custom domains to clients at runtime, such as Kafka advertised listeners.
+When a domain is attached to the private link connection, all traffic to this domain will be routed to this private link connection. It is useful when your service provides custom domains to clients at runtime, such as Kafka advertised listeners.
 
 Different Private Link Connection types support attaching different domains:
 
@@ -61,11 +61,13 @@ You can manage Private Link Connections in the Console or via CLI.
     - **Endpoint Service Name**: Enter your AWS endpoint service name (for example, `com.amazonaws.vpce.<region>.vpce-svc-xxxx`).
 
     > **Note:**
-    > **Note:**
+    >
     > Please make sure the AWS endpoint service:
-    > 1. Is in the same region as the TiDB Cloud cluster.
+    > 
+    > 1. In the same region as your TiDB Cloud cluster.
     > 2. Allows connections from the TiDB Cloud account.
-    > 3. Has availability zones that overlap with the TiDB Cloud cluster.
+    > 3. Has availability zones that overlap with your TiDB Cloud cluster.
+    > 
     > You can get the account ID and available zones information at the bottom of the dialog.
 
 5. Click the **Create Connection** button.
@@ -80,8 +82,9 @@ ticloud serverless private-link-connection create -c <cluster-id> --display-name
 
 Please make sure the AWS endpoint service:
 
-1. Allows the acceptance of TiDB Cloud account.
-2. Has overlapping available zones of TiDB Cloud cluster.
+1. In the same region of your TiDB Cloud cluster.
+2. Allows the acceptance of TiDB Cloud account.
+3. Has overlapping available zones of your TiDB Cloud cluster.
 
 You can get the account ID and available zones information by the following command:
 
@@ -110,16 +113,18 @@ ticloud serverless private-link-connection zones --cluster-id <cluster-id>
 4. Enter the required information in the **Create Private Link Connection** dialog:
 
     - **Private Link Connection Name**: Enter a name for the Private Link Connection.
-    - **Connection Type**: Choose **AliCloud Endpoint Service**, if you can not find this option, please ensure that your cluster is created in Alibaba Cloud provider.
+    - **Connection Type**: Choose **AliCloud Endpoint Service**. If you can not find this option, please ensure that your cluster is created in Alibaba Cloud provider.
     - **Endpoint Service Name**: Enter your Alibaba Cloud endpoint service name (for example, `com.aliyuncs.privatelink.<region>.xxxxx`).
 
     > **Note:**
+    > 
     > Please make sure the Alibaba Cloud endpoint service:
-    > 1. Is in the same region as the TiDB Cloud cluster.
+    > 
+    > 1. In the same region as your TiDB Cloud cluster.
     > 2. Allows connections from the TiDB Cloud account.
-    > 3. Has availability zones that overlap with the TiDB Cloud cluster.
+    > 3. Has availability zones that overlap with your TiDB Cloud cluster.
+    > 
     > You can get the account ID and available zones information at the bottom of the dialog.
-    > You can get the account ID and available zones information in the button of the dialog.
 
 5. Click the **Create Connection** button.
 
@@ -133,9 +138,9 @@ ticloud serverless private-link-connection create -c <cluster-id> --display-name
 
 Please make sure the Alibaba Cloud endpoint service:
 
-1. In the same region of the TiDB Cloud cluster.
+1. In the same region of your TiDB Cloud cluster.
 2. Allows the acceptance of TiDB Cloud account.
-3. Has overlapping available zones of TiDB Cloud cluster.
+3. Has overlapping available zones of your TiDB Cloud cluster.
 
 You can get the account ID and available zones information by the following command:
 
@@ -222,7 +227,7 @@ ticloud serverless private-link-connection attach-domains -c <cluster-id> --priv
 </div>
 </SimpleTab>
 
-## Detach Domains from a Private Link Connection
+### Detach Domains from a Private Link Connection
 
 <SimpleTab>
 <div label="Console">
