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>

diff --git a/doc/cephadm/upgrade.rst b/doc/cephadm/upgrade.rst
index 64ba6dadbb524ae23d951fd85357fd4eab5d6d5a..318938eb3886775088d29d734fbf8c81c7063324 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
+   ceph -s
 
-To upgrade (or downgrade) to a specific release::
+To upgrade (or downgrade) to a specific release:
 
-  # ceph orch upgrade start --ceph-version <version>
+.. prompt:: bash #
+
+  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