diff --git a/docs/guide_migration.rst b/docs/guide_migration.rst
index 2ddec7909..8e47b0df8 100644
--- a/docs/guide_migration.rst
+++ b/docs/guide_migration.rst
@@ -7,7 +7,7 @@
 Migrating cogs from Red V2
 ==========================
 
-First, be sure to read :dpy_docs:`discord.py's migration guide <migrating.html>`
+First, be sure to read :dpy_docs:`discord.py's migration guide <migrating_to_v1.html>`
 as that covers all of the changes to discord.py that will affect the migration process
 
 ----------------
diff --git a/docs/incompatible_changes/3.5.rst b/docs/incompatible_changes/3.5.rst
index 7ea49c90d..bd43fbec4 100644
--- a/docs/incompatible_changes/3.5.rst
+++ b/docs/incompatible_changes/3.5.rst
@@ -446,7 +446,7 @@ discord.py version has been updated to 2.2.3
 To allow Red to continue operating *and* use the newer features (threads, text in voice/stage channels,
 buttons, application commands, and AutoMod, to name a few), we've updated discord.py from version
 1.7.3 to 2.2.3. Since this is a major upgrade, it will require you to update your code accordingly.
-discord.py's documentation has :dpy_docs:`a migration guide <migrating>` that you can follow in order to
+discord.py's documentation has :dpy_docs:`a migration guide <migrating.html>` that you can follow in order to
 update your cogs.
 
 Red itself has already been updated to support all of these changes that happened over the years.