From: Zac Dover <zac.dover@gmail.com>
Date: Mon, 26 Dec 2022 06:05:32 +0000 (+1000)
Subject: doc/glossary: disambiguate clauses
X-Git-Tag: v16.2.11~29^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F49575%2Fhead;p=ceph.git

doc/glossary: disambiguate clauses

Disambiguate various clauses, most of which contain forms of the verb
"to require".

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

diff --git a/doc/glossary.rst b/doc/glossary.rst
index 6c7e4720be92..d7b526b3c754 100644
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -61,9 +61,10 @@
                 See :term:`CephFS`
 
 	:ref:`CephFS<ceph-file-system>`
-                The Ceph File System, or CephFS, is a POSIX-compliant file
-                system built on top of Ceph’s distributed object store, RADOS.
-                See :ref:`CephFS Architecture <arch-cephfs>` for more details.
+                The **Ceph F**\ile **S**\ystem, or CephFS, is a
+                POSIX-compliant file system built on top of Ceph’s distributed
+                object store, RADOS.  See :ref:`CephFS Architecture
+                <arch-cephfs>` for more details.
 
 	Ceph Interim Release
                 A version of Ceph that has not yet been put through quality
@@ -77,8 +78,8 @@
                 The Ceph manager daemon (ceph-mgr) is a daemon that runs
                 alongside monitor daemons to provide monitoring and interfacing
                 to external monitoring and management systems. Since the
-                Luminous release (12.x), the ceph-mgr daemon is required in
-                order for the Ceph cluster to function properly.
+                Luminous release (12.x), no Ceph cluster functions properly
+                unless it contains a running ceph-mgr daemon. 
 
 	Ceph Manager Dashboard
                 See :term:`Ceph Dashboard`.
@@ -89,10 +90,10 @@
 	Ceph Monitor
                 A daemon that maintains a map of the state of the cluster. This
                 "cluster state" includes the monitor map, the manager map, the
-                OSD map, and the CRUSH map. A minimum of three monitors is
-                required in order for the Ceph cluster to be both redundant and
-                highly-available. Ceph monitors and the nodes on which they run
-                are often referred to as "mon"s. See :ref:`Monitor Config
+                OSD map, and the CRUSH map. A Ceph cluster must contain a
+                minimum of three running monitors in order to be both redundant
+                and highly-available. Ceph monitors and the nodes on which they
+                run are often referred to as "mon"s. See :ref:`Monitor Config
                 Reference <monitor-config-reference>`.
 
 	Ceph Node
@@ -235,9 +236,10 @@
                 relationship with OSDs.
 
 	:ref:`MDS<cephfs_add_remote_mds>`
-                The Ceph metadata server daemon. Also referred to as
-                "ceph-mds". The Ceph metadata server daemon is required to run
-                the CephFS file system. The MDS stores all filesystem metadata. 
+                The Ceph **M**\eta\ **D**\ata **S**\erver daemon. Also referred
+                to as "ceph-mds". The Ceph metadata server daemon must be
+                running in any Ceph cluster that runs the CephFS file system.
+                The MDS stores all filesystem metadata. 
 
 	MGR
                 The Ceph manager software, which collects all the state from