diff --git a/keystone/tests/unit/test_sql_banned_operations.py b/keystone/tests/unit/test_sql_banned_operations.py
index cb0459b29b..ba7c1d576e 100644
--- a/keystone/tests/unit/test_sql_banned_operations.py
+++ b/keystone/tests/unit/test_sql_banned_operations.py
@@ -181,7 +181,7 @@ class KeystoneMigrationsCheckers(test_migrations.WalkVersionsMixin):
         # constraint.
         #
         # Please follow the guidelines outlined at:
-        # http://docs.openstack.org/developer/keystone/developing.html#online-migration
+        # http://docs.openstack.org/developer/keystone/devref/development_best_practices.html#database-migrations
 
         if version >= self.first_version and version not in self.exceptions:
             banned_ops = self.banned_ops
diff --git a/keystone/tests/unit/test_sql_upgrade.py b/keystone/tests/unit/test_sql_upgrade.py
index 5f9c7bbcee..3612b7ecf3 100644
--- a/keystone/tests/unit/test_sql_upgrade.py
+++ b/keystone/tests/unit/test_sql_upgrade.py
@@ -1613,7 +1613,7 @@ class VersionTests(SqlMigrateBase):
 
         For more information, see "Database Migrations" here:
 
-            http://docs.openstack.org/developer/keystone/developing.html
+            http://docs.openstack.org/developer/keystone/devref/development_best_practices.html#database-migrations
 
         """
         # Note to reviewers: this version number should never change.
@@ -1636,7 +1636,7 @@ class VersionTests(SqlMigrateBase):
 
         For more information, see "Database Migrations" here:
 
-            http://docs.openstack.org/developer/keystone/developing.html
+            http://docs.openstack.org/developer/keystone/devref/development_best_practices.html#database-migrations
 
         """
         # Transitive comparison: expand == data migration == contract