diff --git a/docs/source/upgrading.md b/docs/source/upgrading.md
index ff55135e..e5e6b0e2 100644
--- a/docs/source/upgrading.md
+++ b/docs/source/upgrading.md
@@ -16,13 +16,15 @@ database:
 
 Let's take a closer look at each step in the upgrade process.
 
-## Backup
+## The upgrade process
 
-## Shutdown
+### Backup
 
-## Upgrade JupyterHub
+### Shutdown
 
-## Run `jupyterhub upgrade-db`
+### Upgrade JupyterHub
+
+### Run `jupyterhub upgrade-db`
 
 
 ## Upgrading a sqlite database