diff --git a/docs/cli/why.md b/docs/cli/why.md
index 221b7a0e6879..42cb35f83b95 100644
--- a/docs/cli/why.md
+++ b/docs/cli/why.md
@@ -5,6 +5,14 @@ title: pnpm why
 
 Shows all packages that depend on the specified package.
 
+:::caution
+
+If the Dependencies Tree has more than 10 results (end leaves), the output will be truncated to 10 end leaves.
+
+This makes the output more readable and avoids memory issues.
+
+:::
+
 ## Options
 
 ### --recursive, -r
@@ -36,6 +44,10 @@ Only display the dependency tree for packages in `dependencies`.
 
 Only display the dependency tree for packages in `devDependencies`.
 
+### --depth <number\>
+
+Display only dependencies within a specific depth.
+
 ### --only-projects
 
 Display only dependencies that are also projects within the workspace.