diff --git a/doc/guide/admin/maintenance.sdf b/doc/guide/admin/maintenance.sdf
index ff8ad323f8..7936316971 100644
--- a/doc/guide/admin/maintenance.sdf
+++ b/doc/guide/admin/maintenance.sdf
@@ -51,8 +51,11 @@ run a checkpoint based on the elapsed amount of minutes flag.
 
 H2: Migration
 
-The simplest steps needed to migrate between versions or upgrade, depending on your deployment
-type are:
+If upgrading, please consult {{SECT:Upgrading from 2.5.x}} first to see if you
+need to make changes to your configuration as part of the upgrade.
+
+After that, the simplest steps needed to migrate between versions or upgrade,
+depending on your deployment type are:
 
 .{{S: }}
 ^{{B: Stop the current server when convenient}}
@@ -66,6 +69,9 @@ type are:
 .{{S: }}
 +{{B: Perform the software upgrades}}
 
+.{{S: }}
++{{B: Perform any configuration upgrades required}}
+
 .{{S: }}
 +{{B: slapadd the exported data back into the directory}}