diff --git a/docs/3.0-migration-guide.md b/docs/3.0-migration-guide.md
index 49b870a171..2b20b5ce6e 100644
--- a/docs/3.0-migration-guide.md
+++ b/docs/3.0-migration-guide.md
@@ -12,9 +12,8 @@ The changes are detailed below, and include:
 
 - Removal of many insecure or obsolete features
 - Tidying up of configuration options (including removing some less useful options).
-- Changing function signatures (e.g., adding return codes or extra parameters); introducing const to arguments.
-- Removal of functions marked as deprecated in 2.x
-
+- Changing function signatures, e.g. adding return codes, adding extra parameters, or making some arguments const.
+- Removal of functions previously marked as deprecated.
 
 
 ## Tooling