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 0e413951c6..a4c7e8729b 100644
--- a/sites/docs/src/content/packages-and-plugins/dependency-management.md
+++ b/sites/docs/src/content/packages-and-plugins/dependency-management.md
@@ -186,9 +186,11 @@ your current 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 upgrades the constraints in your `pubspec.yaml` file
+to allow the latest resolvable versions, and then
+runs `flutter pub get` to retrieve those upgraded dependencies.
 
 ### Use dependency overrides