diff --git a/doc/source/upgrading.rst b/doc/source/upgrading.rst
index 2eb8a3a30..9eeed8ec8 100644
--- a/doc/source/upgrading.rst
+++ b/doc/source/upgrading.rst
@@ -87,6 +87,13 @@ should be obtained either by building them locally or pulling them from an
 image registry.  Second, the overcloud services should be replaced with new
 containers created from the new container images.
 
+Upgrading the Ironic Deployment Images
+--------------------------------------
+
+Prior to upgrading the OpenStack control plane, the baremetal compute nodes
+should be configured to use an updated deployment ramdisk. This procedure is
+not currently automated by kayobe.
+
 Building Container Images
 -------------------------