diff --git a/docs/migration.md b/docs/migration.md
index f4044a3990..f40b2c46cd 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -203,11 +203,11 @@ TODO: audit classes in v3 that aren't present in v4
 
 ### Responsive utilities
 
-The following deprecated variables have been removed in v4.0.0:
+The following variables have been removed in v4.0.0. Use the `media-breakpoint-up()`, `media-breakpoint-down()`, or `media-breakpoint-only()` Sass mixins or the `$grid-breakpoints` Sass map instead of:
 
-* `@screen-phone`, `@screen-tablet`, `@screen-desktop`, `@screen-lg-desktop`. Use the more abstract `$screen-{xs,sm,md,lg,xl}-*` variables instead.
-* `@screen-sm`, `@screen-md`, `@screen-lg`. Use the more clearly named `$screen-{xs,sm,md,lg,xl}-min` variables instead.
-* `@screen-xs`, `@screen-xs-min`. The extra small breakpoint has no lower bound, so these variables were logically absurd. Reformulate your expression in terms of `$screen-xs-max` instead.
+* `@screen-phone`, `@screen-tablet`, `@screen-desktop`, `@screen-lg-desktop`.
+* `@screen-xs`, `@screen-sm`, `@screen-md`, `@screen-lg`.
+* `@screen-xs-min`, `@screen-xs-max`, `@screen-sm-min`, `@screen-sm-max`, `@screen-md-min`, `@screen-md-max`, `@screen-lg-min`, `@screen-lg-max`
 
 The responsive utility classes have also been overhauled.