diff --git a/doc/source/reprepro.rst b/doc/source/reprepro.rst
index 20479a7341..6be76e1193 100644
--- a/doc/source/reprepro.rst
+++ b/doc/source/reprepro.rst
@@ -115,9 +115,27 @@ like::
   # In this removal situation, we should clear out the files now
   # This can take a while depending on the size of what is removed
   $ ${REPREPRO} --nokeepunreferencedfiles deleteunreferenced
+  # Perform an intermediate release as this may take some time.
   # The ssh wrapper is the easiest way to release the volume
   $ source /usr/share/mirror-update/functions.sh
   $ vos_release <mirror.volume>
+  # Next we need to manually clear out some leftover lists/ and dists/
+  # content. Using your openafs account you want to rm the old distro
+  # release dist/ dir and lists/ files.
+  # After kinit and aklog (note no sudo):
+  $ rm -rf /afs/.openstack.org/mirror/<distro>/dists/<release>
+  $ rm /afs/.openstack.org/mirror/<distro>/lists/_<release>_lastseen \
+       /afs/.openstack.org/mirror/<distro>/lists/*<release>_Release \
+       /afs/.openstack.org/mirror/<distro>/lists/*<release>_Release.gpg \
+       /afs/.openstack.org/mirror/<distro>/lists/*<release>_*_Packages
+  # The total number of files may vary from distro release to release
+  # depending on the number of architectures mirrored.
+  # Finally rerun the normal reprepro sync for the distro in order to
+  # ensure this still functions and we haven't deleted too much content.
+  # This will also perform a vos release.
+  $ reprepro-mirror-update /etc/reprepro/<distro> <mirror.volume> >> /var/log/reprepro/<logfile> 2>&1
+  # You can get the reprepro-mirror-update command from crontab -l.
+  # Just drop the flock prefix as we already hold the lock.
   $ exit
 
 Advanced Recovery Techniques