doc/cephadm: enriching "setting a limit"

This PR improves the flow and syntax of the
sentences in the "Setting a Limit" section of the
"Service Management" chapter of the cephadm documentation.
(This section is about setting limits to the number of
daemons created, and about limiting the creation of daemons
to a specified number of hosts.)

Signed-off-by: Zac Dover <zac.dover@gmail.com>
(cherry picked from commit 8db4a8458f4fbaad2b556ec9c2313d370467e5d3)

diff --git a/doc/cephadm/service-management.rst b/doc/cephadm/service-management.rst
index e95faffac8fa0d091bd2a10c682e5db492986471..1e5d8c0d9447e020dfebee212918f6e47690f9ea 100644 (file)
--- a/doc/cephadm/service-management.rst
+++ b/doc/cephadm/service-management.rst
@@ -243,13 +243,13 @@ Or in YAML:
 Setting a limit
 ---------------
 
-By specifying ``count``, only that number of daemons will be created:
+By specifying ``count``, only the number of daemons specified will be created:
 
    .. prompt:: bash #
 
     orch apply prometheus --placement=3
 
-To deploy *daemons* on a subset of hosts, also specify the count:
+To deploy *daemons* on a subset of hosts, specify the count:
 
    .. prompt:: bash #
 
@@ -261,9 +261,9 @@ If the count is bigger than the amount of hosts, cephadm deploys one per host:
 
     orch apply prometheus --placement="3 host1 host2"
 
-results in two Prometheus daemons.
+The command immediately above results in two Prometheus daemons.
 
-Or in YAML:
+YAML can also be used to specify limits, in the following way:
 
 .. code-block:: yaml
 
@@ -271,7 +271,7 @@ Or in YAML:
     placement:
       count: 3
 
-Or with hosts:
+YAML can also be used to specify limits on hosts:
 
 .. code-block:: yaml