doc/glossary: link to OSD material

Link to the OSD material in RADOS Configuration
"Storage Devices".

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

diff --git a/doc/glossary.rst b/doc/glossary.rst
index 32a4f7c317d8fb87f839a7c8baea9614c5a835f6..40aa3df5564740348add9a4f4f40f7dfdd4bc0ae 100644 (file)
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -84,11 +84,17 @@
                 Gateway.
 
        Ceph Object Store
-       Ceph OSD
-               The Ceph OSD software, which interacts with a logical
-               disk (:term:`OSD`). Sometimes, Ceph users use the
-               term "OSD" to refer to "Ceph OSD Daemon", though the
-               proper term is "Ceph OSD".
+       :ref:`Ceph OSD<rados_configuration_storage-devices_ceph_osd>`
+                Ceph **O**\bject **S**\torage **D**\aemon. The Ceph OSD
+                software, which interacts with logical disks (:term:`OSD`).
+                Around 2013, there was an attempt by "research and industry"
+                (Sage's own words) to insist on using the term "OSD" to mean
+                only "Object Storage Device", but the Ceph community has always
+                persisted in using the term to mean "Object Storage Daemon" and
+                no less an authority than Sage Weil himself confirms in
+                November of 2022 that "Daemon is more accurate for how Ceph is
+                built" (private correspondence between Zac Dover and Sage Weil,
+                07 Nov 2022). 
 
        Ceph OSD Daemon
        Ceph OSD Daemons

diff --git a/doc/rados/configuration/storage-devices.rst b/doc/rados/configuration/storage-devices.rst
index 2663b09a2d4eb13fcafe1ace3262f7395207989e..e6da3635f73c9e8c6825059f18256f1b846f2ea8 100644 (file)
--- a/doc/rados/configuration/storage-devices.rst
+++ b/doc/rados/configuration/storage-devices.rst
@@ -4,6 +4,8 @@
 
 There are several Ceph daemons in a storage cluster:
 
+.. _rados_configuration_storage-devices_ceph_osd:
+
 * **Ceph OSDs** (Object Storage Daemons) store most of the data
   in Ceph. Usually each OSD is backed by a single storage device.
   This can be a traditional hard disk (HDD) or a solid state disk