[GitHub] [pulsar] Jennifer88huang commented on a change in pull request #4016: [Issue 3989][Doc] Update Geo Replication docs

[GitBox <gi...@apache.org>]

Jennifer88huang commented on a change in pull request #4016: [Issue 3989][Doc] Update Geo Replication docs
URL: https://github.com/apache/pulsar/pull/4016#discussion_r274225390
 
 

 ##########
 File path: site2/docs/administration-geo.md
 ##########
 @@ -38,19 +38,19 @@ Applications can create producers and consumers in any of the clusters, even whe
 > #### Subscriptions are local to a cluster
 > While producers and consumers can publish to and consume from any cluster in a Pulsar instance, subscriptions are local to the clusters in which they are created and cannot be transferred between clusters. If you do need to transfer a subscription, you’ll need to create a new subscription in the desired cluster.
 
-In the example in the image above, the topic **T1** is being replicated between 3 clusters, **Cluster-A**, **Cluster-B**, and **Cluster-C**.
+In the aforementioned example, the **T1** topic is being replicated among three clusters, **Cluster-A**, **Cluster-B**, and **Cluster-C**.
 
-All messages produced in any cluster will be delivered to all subscriptions in all the other clusters. In this case, consumers **C1** and **C2** will receive all messages published by producers **P1**, **P2**, and **P3**. Ordering is still guaranteed on a per-producer basis.
+All messages produced in any of the three clusters are delivered to all subscriptions in other clusters. In this case, **C1** and **C2** consumers will receive all messages published by **P1**, **P2**, and **P3** producers. Ordering is still guaranteed on a per-producer basis.
 
 ## Configuring replication
 
-As stated [above](#geo-replication-and-pulsar-properties), geo-replication in Pulsar is managed at the [tenant](reference-terminology.md#tenant) level.
+As stated in [Geo-replication and Pulsar properties](#geo-replication-and-pulsar-properties) section, geo-replication in Pulsar is managed at the [tenant](reference-terminology.md#tenant) level.
 
 ### Granting permissions to properties
 
-To establish replication to a cluster, the tenant needs permission to use that cluster. This permission can be granted when the tenant is created or later on.
+To replicate to a cluster, the tenant needs permission to use that cluster. You can grant permission to the tenant when you create it or grant later.
 
-At creation time, specify all the intended clusters:
+Specify all the intended clusters when creating a tenant:
 
 ```shell
 $ bin/pulsar-admin properties create my-tenant \
 
 Review comment:
   ok, i'll refine it.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services