doc: Updated text with new glossary terms.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>

diff --git a/doc/start/index.rst b/doc/start/index.rst
index e6e6ed2842b485ae72df9c798c20d198be11ef2c..cee41996627be0bc0414ef11f7bb9994897af699 100644 (file)
--- a/doc/start/index.rst
+++ b/doc/start/index.rst
@@ -2,30 +2,32 @@
  Getting Started
 =================
 
-Whether you want to provide RESTful object services and/or block devices to a
-cloud solution, deploy a CephFS filesystem or use Ceph for another purpose, all
-Ceph clusters begin with setting up your host computers, network and the Ceph
-Object Store. A Ceph object store cluster has three essential daemons:
+Whether you want to provide :term:`Ceph Object Storage` and/or :term:`Ceph Block
+Device` services to :term:`Cloud Platforms`, deploy a :term:`Ceph Filesystem` or
+use Ceph for another purpose, all :term:`Ceph Storage Cluster` deployments begin
+with setting up each :term:`Ceph Node`, your network and the Ceph Storage
+Cluster. A Ceph Storage Cluster has three essential daemons:
 
 .. ditaa::  +---------------+ +---------------+ +---------------+
             |      OSDs     | |    Monitor    | |      MDS      |
             +---------------+ +---------------+ +---------------+
 
-- **OSDs**: Object Storage Daemons (OSDs) store data, handle data replication, 
-  recovery, backfilling, rebalancing, and provide some monitoring information
-  to Ceph monitors by checking other OSDs for a heartbeat. A cluster requires
-  at least two OSDs to achieve an ``active + clean`` state.
+- **OSDs**: A :term:`Ceph OSD Daemon` (OSD) stores data, handles data 
+  replication, recovery, backfilling, rebalancing, and provides some monitoring
+  information to Ceph Monitors by checking other Ceph OSD Daemons for a 
+  heartbeat. A Ceph Storage Cluster requires at least two Ceph OSD Daemons to 
+  achieve an ``active + clean`` state.
   
-- **Monitors**: Ceph monitors maintain maps of the cluster state, including 
-  the monitor map, the OSD map, the Placement Group (PG) map, and the CRUSH 
-  map. Ceph maintains a history (called an "epoch") of each state change in 
-  the monitors, OSDs, and PGs.
+- **Monitors**: A :term:`Ceph Monitor` maintains maps of the cluster state, 
+  including the monitor map, the OSD map, the Placement Group (PG) map, and the
+  CRUSH map. Ceph maintains a history (called an "epoch") of each state change 
+  in the Ceph Monitors, Ceph OSD Daemons, and PGs.
 
-- **MDSs**: Metadata Servers (MDSs) store metadata on behalf of the CephFS
-  filesystem (i.e., Ceph block devices and Ceph gateways do not use MDS).
-  Ceph MDS servers make it feasible for POSIX file system users to execute
-  basic commands like ``ls``, ``find``, etc. without placing an enormous
-  burden on the object store.
+- **MDSs**: A :term:`Ceph Metadata Server` (MDS) stores metadata on behalf of 
+  the :term:`Ceph Filesystem` (i.e., Ceph Block Devices and Ceph Object Storage
+  do not use MDS). Ceph Metadata Servers make it feasible for POSIX file system 
+  users to execute basic commands like ``ls``, ``find``, etc. without placing 
+  an enormous burden on the Ceph Storage Cluster.
 
 
 .. raw:: html
@@ -33,9 +35,9 @@ Object Store. A Ceph object store cluster has three essential daemons:
        <style type="text/css">div.body h3{margin:5px 0px 0px 0px;}</style>
        <table cellpadding="10"><colgroup><col width="33%"><col width="33%"><col width="33%"></colgroup><tbody valign="top"><tr><td><h3>Step 1: Preflight</h3>
 
-Client and server machines may require some basic configuration work prior to
-deploying a Ceph cluster. You can also avail yourself of help from the Ceph 
-community by getting involved.
+A :term:`Ceph Client` and a :term:`Ceph Node` may require some basic
+configuration  work prior to deploying a Ceph Storage Cluster. You can also
+avail yourself of help  from the Ceph community by getting involved.
 
 .. toctree::
 
@@ -59,12 +61,12 @@ deploying a Ceph Storage Cluster.
        </td><td><h3>Step 3: Ceph Client(s)</h3>
        
 Most Ceph users don't store objects directly in the Ceph Storage Cluster. They typically use at least one of
-Ceph Block Devices, the Ceph FS filesystem, and Ceph Object Storage.
+Ceph Block Devices, the Ceph Filesystem, and Ceph Object Storage.
 
 .. toctree::
        
    Block Device Quick Start <quick-rbd>
-   Ceph FS Quick Start <quick-cephfs>
+   Filesystem Quick Start <quick-cephfs>
    Object Storage Quick Start <quick-rgw>