From: Zac Dover Date: Fri, 17 Nov 2023 09:24:14 +0000 (+1000) Subject: doc/start: explain "OSD" X-Git-Tag: v19.0.0~70^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F54545%2Fhead;p=ceph.git doc/start: explain "OSD" Explain the initialism "OSD" and link to its definition in the glossary. This PR is raised in response to an anonymous documentation bug that reads "Paragraph 2 uses the acronym OSD without any explanation. This makes it very difficult to understand this part of the documentation as there is no indication of what this acronym is until much further into the documentation. Replace first occurence of OSD with Object Storage Daemon (OSD) or link it to the glossary." -- https://pad.ceph.com/p/Report_Documentation_Bugs Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover --- diff --git a/doc/start/intro.rst b/doc/start/intro.rst index 3a50a8733676..9881a7205487 100644 --- a/doc/start/intro.rst +++ b/doc/start/intro.rst @@ -9,10 +9,10 @@ System`. All :term:`Ceph Storage Cluster` deployments begin with setting up each :term:`Ceph Node` and then setting up the network. A Ceph Storage Cluster requires the following: at least one Ceph Monitor and at -least one Ceph Manager, and at least as many Ceph OSDs as there are copies of -an object stored on the Ceph cluster (for example, if three copies of a given -object are stored on the Ceph cluster, then at least three OSDs must exist in -that Ceph cluster). +least one Ceph Manager, and at least as many :term:`Ceph Object Storage +Daemon`\s (OSDs) as there are copies of a given object stored in the +Ceph cluster (for example, if three copies of a given object are stored in the +Ceph cluster, then at least three OSDs must exist in that Ceph cluster). The Ceph Metadata Server is necessary to run Ceph File System clients.