diff --git a/docs/migration-v8.md b/docs/migration-v8.md
index aaa396f0e88..d67b8c6be8b 100644
--- a/docs/migration-v8.md
+++ b/docs/migration-v8.md
@@ -16,7 +16,11 @@ Welcome to the migration guide for Polly's v8 version. The v8 version of Polly b
 - **Built-in telemetry**: Polly v8 now has built-in telemetry support.
 - **Improved performance and low-allocation APIs**: Polly v8 boasts significant performance enhancements and provides zero-allocation APIs for advanced use cases.
 
-## Migrating policies
+## Migrating execution policies
+
+This section describes how to migrate from execution policies (i.e. `IAsyncPolicy`, `ISyncPolicy`) to resilience pipelines (i.e. `ResiliencePipeline`, `ResiliencePipeline<T>`).
+
+### Configuring policies in v7
 
 In earlier versions, Polly exposed various interfaces to execute user code:
 
@@ -25,8 +29,6 @@ In earlier versions, Polly exposed various interfaces to execute user code:
 - `ISyncPolicy`
 - `ISyncPolicy<T>`
 
-### Configuring policies in v7
-
 These interfaces were created and used as:
 
 <!-- snippet: migration-policies-v7 -->
@@ -148,7 +150,7 @@ Here are the primary changes:
 - The final `ResiliencePipeline` is created with a `Build()` call.
 - `ResiliencePipeline` can execute both synchronous and asynchronous tasks.
 
-## Migrating `PolicyWrap`
+## Migrating policy wrap
 
 ### Policy wrap in v7