Merge pull request ceph#60846 from anthonyeleven/improve-archive-sync

doc/radosgw: Improve archive-sync-module

Reviewed-by: Zac Dover <[email protected]>

Author: zdover23

doc/radosgw/archive-sync-module.rst

@@ -4,34 +4,30 @@ Archive Sync Module
 
 .. versionadded:: Nautilus
 
-This sync module leverages the versioning feature of the S3 objects in RGW to
-have an archive zone that captures the different versions of the S3 objects
-as they occur over time in the other zones.
+The Archive Sync module uses the RGW versioning feature of S3 objects to
+maintain an archive zone that captures successive versions of objects
+as they are updated in other zones.  Archive zone objects can
+only be removed through gateways associated with the archive zone.
 
-An archive zone allows to have a history of versions of S3 objects that can
-only be eliminated through the gateways associated with the archive zone.
-
-This functionality is useful to have a configuration where several
+This enables a deployment where several
 non-versioned zones replicate their data and metadata through their zone
 gateways (mirror configuration) providing high availability to the end users,
-while the archive zone captures all the data updates and metadata for
-consolidate them as versions of S3 objects.
+while the archive zone captures data and metadata updates.
 
-Including an archive zone in a multizone configuration allows you to have the
-flexibility of an S3 object history in one only zone while saving the space
-that the replicas of the versioned S3 objects would consume in the rest of the
+Deploying an archive zone in a multizone configuration enables the
+flexibility of S3 object history in a single zone while saving the space
+that replicas of versioned S3 objects would consume in the rest of the
 zones.
 
 
-
 Archive Sync Tier Type Configuration
 ------------------------------------
 
 How to Configure
 ~~~~~~~~~~~~~~~~
 
-See `Multisite Configuration`_ for how to multisite config instructions. The
-archive sync module requires a creation of a new zone. The zone tier type needs
+See `Multisite Configuration`_ for multisite configuration instructions. The
+archive sync module requires the creation of a new zone. The zone tier type needs
 to be defined as ``archive``:
 
 ::