diff --git a/doc/source/upgrade-guide/manual-upgrade.rst b/doc/source/upgrade-guide/manual-upgrade.rst
index bda42531da..d1079e5b1c 100644
--- a/doc/source/upgrade-guide/manual-upgrade.rst
+++ b/doc/source/upgrade-guide/manual-upgrade.rst
@@ -57,6 +57,18 @@ inventory is found automatically.
 
     # cd playbooks
 
+Cleanup old facts
+~~~~~~~~~~~~~~~~~
+
+Some configuration changed, and old facts should be purged before
+the upgrade.
+
+See :ref:`fact-cleanup-playbook` for more details.
+
+.. code-block:: console
+
+    # openstack-ansible "${UPGRADE_PLAYBOOKS}/ansible_fact_cleanup.yml"
+
 Update configuration and environment files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -123,7 +135,7 @@ See :ref:`repo-server-pip-conf-removal` for more details.
     # openstack-ansible "${UPGRADE_PLAYBOOKS}/repo-server-pip-conf-removal.yml"
 
 Ensure hostname aliases are created for non-RFC1034/35 hostnames
-----------------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Ensure an alias is created for non-RFC1034/35 hostnames.
 
@@ -149,6 +161,15 @@ See :ref:`setup-infra-playbook` for details.
     # openstack-ansible setup-infrastructure.yml -e 'galera_upgrade=true' \
     -e 'rabbitmq_upgrade=true'
 
+Flush Memcached cache
+~~~~~~~~~~~~~~~~~~~~~
+
+See :ref:`memcached-flush` for details.
+
+.. code-block:: console
+
+    # openstack-ansible "${UPGRADE_PLAYBOOKS}/memcached-flush.yml"
+
 Upgrade OpenStack
 ~~~~~~~~~~~~~~~~~
 
diff --git a/doc/source/upgrade-guide/upgrade-playbooks.rst b/doc/source/upgrade-guide/upgrade-playbooks.rst
index 41a4a88c4a..867e1f2958 100644
--- a/doc/source/upgrade-guide/upgrade-playbooks.rst
+++ b/doc/source/upgrade-guide/upgrade-playbooks.rst
@@ -8,6 +8,13 @@ Within the main :file:`scripts` directory there is an :file:`upgrade-utilities`
 directory, which contains an additional playbooks directory. These playbooks
 facilitate the upgrade process.
 
+.. _fact-cleanup-playbook:
+
+``ansible_fact_cleanup.yml``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This calls a script to removes files in ``/etc/openstack_deploy/ansible_facts/``
+
 .. _config-change-playbook:
 
 ``deploy-config-changes.yml``
@@ -81,6 +88,13 @@ upgrade RabbitMQ.
 The ``galera_upgrade`` variable tells the ``galera_server`` role to remove the
 current version of MariaDB and Galera and upgrade to the 10.x series.
 
+.. _memcached-flush:
+
+``memcached-flush.yml``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Sends "flush_all" to memcached with the help of nc.
+
 --------------
 
 .. include:: navigation.txt