doc/start: rewrite CRUSH para

This PR supersedes https://github.com/ceph/ceph/pull/46584
and makes changes suggested by Anthony D'Atri that improve
the coherence and consistency of the paragraph that explains
the basics of the CRUSH algorithm.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

diff --git a/doc/start/intro.rst b/doc/start/intro.rst
index 1f1eb9b383e89c734a892ff77c0df5e3ce9a759f..e46236e6f59e419d12b3739770c997b6ee104a5d 100644 (file)
--- a/doc/start/intro.rst
+++ b/doc/start/intro.rst
@@ -49,10 +49,10 @@ required when running Ceph File System clients.
   Ceph Storage Cluster.
 
 Ceph stores data as objects within logical storage pools. Using the
-:term:`CRUSH` algorithm, Ceph calculates which placement group should
-contain the object, and further calculates which Ceph OSD Daemon
-should store the placement group.  The CRUSH algorithm enables the
-Ceph Storage Cluster to scale, rebalance, and recover dynamically.
+:term:`CRUSH` algorithm, Ceph calculates which placement group (PG) should
+contain the object, and which OSD should store the placement group.  The
+CRUSH algorithm enables the Ceph Storage Cluster to scale, rebalance, and
+recover dynamically.
 
 .. _REST API: ../../mgr/restful