diff --git a/doc/source/user/upgrade.rst b/doc/source/user/upgrade.rst
index b83f84664b9b..0b7dfe229908 100644
--- a/doc/source/user/upgrade.rst
+++ b/doc/source/user/upgrade.rst
@@ -84,8 +84,8 @@ same time.
    * Several nova services rely on the external placement service being at the
      latest level. Therefore, you must upgrade placement before any nova
      services. See the
-     :placement-doc:`placement upgrade notes <#upgrade-notes>` for more
-     details on upgrading the placement service.
+     :placement-doc:`placement upgrade notes <admin/upgrade-notes.html>` for
+     more details on upgrading the placement service.
 
    * For maximum safety (no failed API operations), gracefully shutdown all
      the services (i.e. SIG_TERM) except nova-compute.