doc/cephadm: rewrite "index.rst"

This PR rewrites the three paragraphs at the
front of the cephadm guide, increasing their
elegance and removing ambiguities.

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

diff --git a/doc/cephadm/index.rst b/doc/cephadm/index.rst
index 02d7430ba444baa19b18fd66872a248db8c7c452..d9531d51ca58cf95dca588d81706962db4de0f8d 100644 (file)
--- a/doc/cephadm/index.rst
+++ b/doc/cephadm/index.rst
@@ -4,19 +4,20 @@
 Cephadm
 =======
 
-Cephadm deploys and manages a Ceph cluster by connection to hosts from the
-manager daemon via SSH to add, remove, or update Ceph daemon containers.  It
-does not rely on external configuration or orchestration tools like Ansible,
-Rook, or Salt.
-
-Cephadm manages the full lifecycle of a Ceph cluster.  It starts
-by bootstrapping a tiny Ceph cluster on a single node (one monitor and
-one manager) and then uses the orchestration interface ("day 2"
-commands) to expand the cluster to include all hosts and to provision
-all Ceph daemons and services.  This can be performed via the Ceph
-command-line interface (CLI) or dashboard (GUI).
-
-Cephadm is new in the Octopus v15.2.0 release and does not support older
+``cephadm`` deploys and manages a Ceph cluster. It does this by connecting the
+manager daemon to hosts via SSH. The manager daemon is able to add, remove, and
+update Ceph containers. ``cephadm`` does not rely on external configuration
+tools such as Ansible, Rook, and Salt.
+
+``cephadm`` manages the full lifecycle of a Ceph cluster. This lifecycle
+starts with the bootstrapping process, when ``cephadm`` creates a tiny
+Ceph cluster on a single node. This cluster consists of one monitor and
+one manager. ``cephadm`` then uses the orchestration interface ("day 2"
+commands) to expand the cluster, adding all hosts and provisioning all
+Ceph daemons and services. Management of this lifecycle can be performed
+either via the Ceph command-line interface (CLI) or via the dashboard (GUI).
+
+``cephadm`` is new in Ceph release v15.2.0 (Octopus) and does not support older
 versions of Ceph.
 
 .. note::