diff --git a/docs/3.0-migration-guide.md b/docs/3.0-migration-guide.md
index 0e156b429d..b9200ac09f 100644
--- a/docs/3.0-migration-guide.md
+++ b/docs/3.0-migration-guide.md
@@ -16,7 +16,7 @@ The changes are detailed below, and include:
 - Removal of functions previously marked as deprecated.
 
 
-## Tooling
+## General changes
 
 ### Introduce a level of indirection and versioning in the config files
 
@@ -493,7 +493,7 @@ names provided by the 1.0 specification instead.
 
 
 
-## The ALT interface
+## Changes that only affect alternative implementations
 
 ### Internal / alt-focused headers were moved to a private location