doc/radosgw: generalize description of Zone Features

so they make sense outside of multisite configurations

Signed-off-by: Casey Bodley <cbodley@redhat.com>
(cherry picked from commit 0a97eb89e1d9c99e96fd215e9dc31febc2e44de5)

diff --git a/doc/radosgw/zone-features.rst b/doc/radosgw/zone-features.rst
index d397af9db00340b9f4182ccda7842c0eb177d122..b439fd9dfd26f1933fcde773dd14b1596f76105a 100644 (file)
--- a/doc/radosgw/zone-features.rst
+++ b/doc/radosgw/zone-features.rst
@@ -2,9 +2,9 @@
 Zone Features
 =============
 
-Some multisite features require support from all zones before they can be enabled. Each zone lists its ``supported_features``, and each zonegroup lists its ``enabled_features``. Before a feature can be enabled in the zonegroup, it must be supported by all of its zones.
+Some features require support from all cooperating radosgws before they can be enabled. Each zone lists its ``supported_features``, and each zonegroup lists its ``enabled_features``. Before a feature can be enabled in the zonegroup, it must be supported by all of its zones.
 
-On creation of new zones and zonegroups, all known features are supported and some features (see table below) are enabled by default. After upgrading an existing multisite configuration, however, new features must be enabled manually.
+On creation of new zones and zonegroups, all known features are supported and some features (see table below) are enabled by default. After upgrading an existing zone, however, new features must be enabled manually.
 
 Supported Features
 ------------------
@@ -62,6 +62,9 @@ On the cluster that contains the given zone:
    radosgw-admin zone modify --rgw-zone={zone-name} --enable-feature={feature-name}
    radosgw-admin period update --commit
 
+.. note:: The ``period update`` command only works if the zone belongs to a realm.
+   Otherwise, all radosgws will need to restart before they notice the change.
+
 
 Remove support for a zone feature
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~