doc/cephadm: rewriting "starting the upgrade"

This PR fixes the prompts in this section and
makes the sentences a tiny bit less onerous for
the reader.

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

diff --git a/doc/cephadm/upgrade.rst b/doc/cephadm/upgrade.rst
index 2cc35e2b46b16223e399c41aa3494f1352da0cb0..8b6023e82ad5e16a88aa7f8b23857ef9370d8bb8 100644 (file)
--- a/doc/cephadm/upgrade.rst
+++ b/doc/cephadm/upgrade.rst
@@ -19,20 +19,23 @@ Keep in mind that the Ceph cluster health status is likely to switch to
 Starting the upgrade
 ====================
 
-Before you start, you should verify that all hosts are currently online
-and your cluster is healthy.
+Before you begin using cephadm to upgrade Ceph, verify that all hosts are currently online and that your cluster is healthy:
 
-::
+.. prompt:: bash #
+
+   ceph -s
+
+To upgrade (or downgrade) to a specific release:
 
-  # ceph -s
+.. prompt:: bash #
 
-To upgrade (or downgrade) to a specific release::
+  ceph orch upgrade start --ceph-version <version>
 
-  # ceph orch upgrade start --ceph-version <version>
+For example, to upgrade to v15.2.1:
 
-For example, to upgrade to v15.2.1::
+.. prompt:: bash #
 
-  # ceph orch upgrade start --ceph-version 15.2.1
+  ceph orch upgrade start --ceph-version 15.2.1
 
 
 Monitoring the upgrade