diff --git a/docs/source/upgrading.md b/docs/source/upgrading.md
index e5e6b0e2..2b241d46 100644
--- a/docs/source/upgrading.md
+++ b/docs/source/upgrading.md
@@ -1,23 +1,23 @@
 # Upgrading JupyterHub and its database
 
 From time to time, you may wish to upgrade JupyterHub to take advantage
-of new releases. While much of this process is automated using scripts,
-such as those generated by alembic for database upgrades, it's critical
-to backup data and configurations before shutting down the JupyterHub
-process and server.
-
-Four fundamental steps are needed when upgrading JupyterHub and its
-database:
-
-1. Backup
-2. Shutdown
-3. Upgrade JupyterHub
-4. Run `jupyterhub upgrade-db` to upgrade the database
-
-Let's take a closer look at each step in the upgrade process.
+of new releases. Much of this process is automated using scripts,
+such as those generated by alembic for database upgrades. Before upgrading a
+JupyterHub deployment, it's critical to backup your data and configurations
+before shutting down the JupyterHub process and server.
 
 ## The upgrade process
 
+Four fundamental process steps are needed when upgrading JupyterHub and its
+database:
+
+1. Backup your Hub's data and configurations
+2. Shutdown the Hub
+3. Upgrade JupyterHub
+4. Upgrade the database using run `jupyterhub upgrade-db`
+
+Let's take a closer look at each step in the upgrade process.
+
 ### Backup
 
 ### Shutdown
@@ -28,6 +28,3 @@ Let's take a closer look at each step in the upgrade process.
 
 
 ## Upgrading a sqlite database
-
-
-