diff --git a/website/docs/intro/migration/index.mdx b/website/docs/intro/migration/index.mdx
index e6081b65b8..5db38c0a1c 100644
--- a/website/docs/intro/migration/index.mdx
+++ b/website/docs/intro/migration/index.mdx
@@ -7,7 +7,7 @@ description: |-
 
 import DocCardList from "@theme/DocCardList";
 
-## Migrating to OpenTofu 1.7.x from Terraform
+# Migrating to OpenTofu 1.7.x from Terraform
 
 Please select the Terraform version you are migrating from:
 
diff --git a/website/docs/intro/migration/terraform-1.5-or-lower.mdx b/website/docs/intro/migration/terraform-1.5-or-lower.mdx
index 20505ff647..420335732d 100644
--- a/website/docs/intro/migration/terraform-1.5-or-lower.mdx
+++ b/website/docs/intro/migration/terraform-1.5-or-lower.mdx
@@ -2,7 +2,7 @@
 sidebar_position: 6
 sidebar_label: Migrating from Terraform 1.5.x or lower
 description: |-
-    Learn how to migrate to OpenTofu 1.7.0 from Terraform 1.5.x or lower.
+    Learn how to migrate to OpenTofu from Terraform 1.5.x or lower.
 ---
 
 # Migrating to OpenTofu from Terraform 1.5.x or lower
@@ -104,8 +104,8 @@ change.
 
 ## Step 9: Upgrade to the latest OpenTofu version
 
-Now that the migration is complete, follow the [upgrade guide](../upgrading.mdx) for OpenTofu to upgrade to the latest
-version.
+Now that the migration is complete, follow the [upgrade guide](/docs/intro/upgrading/) for OpenTofu to upgrade to the
+latest version.
 
 ## Rolling back to Terraform and reporting issues
 
diff --git a/website/docs/intro/migration/terraform-1.6.mdx b/website/docs/intro/migration/terraform-1.6.mdx
index adb0f3f96d..c56231021e 100644
--- a/website/docs/intro/migration/terraform-1.6.mdx
+++ b/website/docs/intro/migration/terraform-1.6.mdx
@@ -118,8 +118,8 @@ change.
 
 ## Step 10: Upgrade to the latest OpenTofu version
 
-Now that the migration is complete, follow the [upgrade guide](../upgrading.mdx) for OpenTofu to upgrade to the latest
-version.
+Now that the migration is complete, follow the [upgrade guide](/docs/intro/upgrading/) for OpenTofu to upgrade to the
+latest version.
 
 ## Rolling back to Terraform and reporting issues
 
diff --git a/website/docs/intro/migration/terraform-1.7.mdx b/website/docs/intro/migration/terraform-1.7.mdx
index b32a129afd..0440dd88ca 100644
--- a/website/docs/intro/migration/terraform-1.7.mdx
+++ b/website/docs/intro/migration/terraform-1.7.mdx
@@ -8,7 +8,7 @@ description: |-
 # Migrating to OpenTofu from Terraform 1.7.x
 
 When migrating from Terraform 1.7.x, please migrate to OpenTofu 1.7.0 first, then
-[upgrade your OpenTofu installation](../upgrading.mdx) to the latest version.
+[upgrade your OpenTofu installation](/docs/intro/upgrading/) to the latest version.
 
 OpenTofu 1.7.0 is largely compatible with Terraform 1.7.x with a few minor changes needed. This migration guide will
 take you through the process of switching from Terraform to OpenTofu.
@@ -130,8 +130,8 @@ change.
 
 ## Step 10: Upgrade to the latest OpenTofu version
 
-Now that the migration is complete, follow the [upgrade guide](../upgrading.mdx) for OpenTofu to upgrade to the latest
-version.
+Now that the migration is complete, follow the [upgrade guide](/docs/intro/upgrading/) for OpenTofu to upgrade to the
+latest version.
 
 ## Rolling back to Terraform and reporting issues
 
diff --git a/website/docs/intro/migration/terraform-1.8.mdx b/website/docs/intro/migration/terraform-1.8.mdx
index dcffc0d429..af85af31f9 100644
--- a/website/docs/intro/migration/terraform-1.8.mdx
+++ b/website/docs/intro/migration/terraform-1.8.mdx
@@ -127,6 +127,11 @@ updates the state file.
 Before you begin using OpenTofu for larger changes, test out `tofu apply` with a smaller, non-critical
 change.
 
+## Step 10: Upgrade to the latest OpenTofu version
+
+Now that the migration is complete, follow the [upgrade guide](/docs/intro/upgrading/) for OpenTofu to upgrade to the
+latest version.
+
 ## Rolling back to Terraform and reporting issues
 
 If you have issues migrating to OpenTofu you can follow these steps to roll back to Terraform:
diff --git a/website/docs/intro/whats-new.mdx b/website/docs/intro/whats-new.mdx
index 3ec527580f..161dc6d7d2 100644
--- a/website/docs/intro/whats-new.mdx
+++ b/website/docs/intro/whats-new.mdx
@@ -200,9 +200,9 @@ There are also several changes to the CLI:
 - `tofu console` now works on Solaris and AIX.
 - The CLI now supports the XDG directory specification.
 - Aliases for:
-- `state list` → `state ls`
-- `state mv` → `state move`
-- `state rm` → `state remove`
+    - `state list` → `state ls`
+    - `state mv` → `state move`
+    - `state rm` → `state remove`
 
 ## Testing feature changes