diff --git a/sites/docs/src/content/packages-and-plugins/dependency-management.md b/sites/docs/src/content/packages-and-plugins/dependency-management.md
index 08664ae115..99da1babf8 100644
--- a/sites/docs/src/content/packages-and-plugins/dependency-management.md
+++ b/sites/docs/src/content/packages-and-plugins/dependency-management.md
@@ -179,9 +179,9 @@ constraints, run:
 flutter pub outdated
 ```
 
-If newer versions exist,
-update the version constraints in your `pubspec.yaml` to the newer versions and
-run `flutter pub get`.
+To upgrade to newer major versions, run `flutter pub upgrade --major-versions`.
+This command automatically upgrades the constraints in your `pubspec.yaml` and
+then runs `flutter pub get` to retrieve those upgraded dependencies.
 
 ### Use dependency overrides