From 82343262d9617203de524d1f058614370dfa8487 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Mon, 26 Dec 2022 16:05:32 +1000 Subject: [PATCH] doc/glossary: disambiguate clauses Disambiguate various clauses, most of which contain forms of the verb "to require". Signed-off-by: Zac Dover (cherry picked from commit 643f430a0f82b4018b0076883a249e4556bc956a) --- doc/glossary.rst | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/doc/glossary.rst b/doc/glossary.rst index 6c7e4720be923..d7b526b3c7547 100644 --- a/doc/glossary.rst +++ b/doc/glossary.rst @@ -61,9 +61,10 @@ See :term:`CephFS` :ref:`CephFS` - 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 ` 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 + ` 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 `. Ceph Node @@ -235,9 +236,10 @@ relationship with OSDs. :ref:`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 -- 2.39.5