diff --git a/docs/repo-docs/crafting-your-repository/managing-dependencies.mdx b/docs/repo-docs/crafting-your-repository/managing-dependencies.mdx
index cf621d4ee3c13..a27b8bd5d1c8a 100644
--- a/docs/repo-docs/crafting-your-repository/managing-dependencies.mdx
+++ b/docs/repo-docs/crafting-your-repository/managing-dependencies.mdx
@@ -120,6 +120,14 @@ Note that Turborepo does not play a role in managing your dependencies, leaving
 
 It's up to the package manager to handle things like downloading the right external dependency version, symlinking, and resolving modules. The recommendations on this page are best practices for managing dependencies in a Workspace, and are not enforced by Turborepo.
 
+### Module resolution differs amongst package managers
+
+Package managers have different module resolution algorithms, which leads to differences in behavior that can be difficult to predict.
+
+In the Turborepo documentation, we make many recommendations according to the expected behaviors of the package managers. Our coverage of how to handle dependencies is best effort and you may need to adapt the documented behavior for your package manager or repository's needs.
+
+However, if you find an issue with the documentation that appears to be universally incorrect for all package managers or a specific one, please let us know with a GitHub Issue so we can improve.
+
 ### node_modules locations
 
 Depending on your choice of package manager, version, settings, and where your dependencies are installed in your Workspace, you may see `node_modules` and the dependencies inside it in various locations within the Workspace. Dependencies could be found in the root `node_modules`, in packages' `node_modules`, or both.