doc/cephadm: break mon section into sections

This PR breaks the "Deploy Additional Monitors" section
of the cephadm documentation into several subsections
whose titles spotlight the matter under discussion in
those respective subsections.

inb4: Another PR is on deck that rewrites the sentences
in this chapter of the cephadm documentation. I'd like
to get this chapter broken up into these subsections before
I rewrite those sentences. So I'm hoping for no grammatical
mission creep on this one. The grammar and clarity updates
are coming.

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

diff --git a/doc/cephadm/mon.rst b/doc/cephadm/mon.rst
index 818368e6ef2611fafb6f72ebb1dfbeeea388eb2a..38ae493f5ff2e726fe9cf7d25232aa59f95497f9 100644 (file)
--- a/doc/cephadm/mon.rst
+++ b/doc/cephadm/mon.rst
@@ -4,8 +4,8 @@ MON Service
 
 .. _deploy_additional_monitors:
 
-Deploying additional monitors (beyond the default three)
-========================================================
+Deploying additional monitors 
+-----------------------------
 
 A typical Ceph cluster has three or five monitor daemons that are spread
 across different hosts.  We recommend deploying five monitors if there are
@@ -29,7 +29,7 @@ manual administration of the ceph monitor daemons is not necessary.
 needed, as new hosts are added to the cluster. 
 
 Designating a Particular Subnet for Monitors
-============================================
+--------------------------------------------
 
 To designate a particular IP subnet for use by ceph monitor daemons, use a
 command of the following form, including the subnet's address in `CIDR`_
@@ -49,18 +49,18 @@ Cephadm deploys new monitor daemons only on hosts that have IP addresses in
 the designated subnet.
 
 Changing the number of monitors from the default
-================================================
+------------------------------------------------
 
-* If you want to adjust the default of 5 monitors, run this command:
+If you want to adjust the default of 5 monitors, run this command:
 
   .. prompt:: bash #
 
      ceph orch apply mon *<number-of-monitors>*
 
 Deploying monitors only to specific hosts
-=========================================
+-----------------------------------------
 
-* To deploy monitors on a specific set of hosts, run this command:
+To deploy monitors on a specific set of hosts, run this command:
 
   .. prompt:: bash #
 
@@ -69,11 +69,10 @@ Deploying monitors only to specific hosts
   Be sure to include the first (bootstrap) host in this list.
 
 Using Host Labels
-=================
+-----------------
 
-* You can control which hosts the monitors run on by making use of
-  host labels.  To set the ``mon`` label to the appropriate
-  hosts, run this command:
+You can control which hosts the monitors run on by making use of host labels.
+To set the ``mon`` label to the appropriate hosts, run this command:
   
   .. prompt:: bash #
 
@@ -109,12 +108,14 @@ Using Host Labels
 
     ceph orch apply mon label:mon
 
-Deploying Monitors Manually 
-===========================
+See also :ref:`host labels <orchestrator-host-labels>`.
 
-* You can explicitly specify the IP address or CIDR network for each monitor
-  and control where it is placed.  To disable automated monitor deployment, run
-  this command:
+Deploying Monitors on a Particular Network 
+------------------------------------------
+
+You can explicitly specify the IP address or CIDR network for each monitor and
+control where each monitor is placed.  To disable automated monitor deployment,
+run this command:
 
   .. prompt:: bash #