docs: document resolutions and pnpm.overrides merging (#463)

Docs change for pnpm/pnpm#7174.
pnpm · Oct 9, 2023 · b36e9c3 · b36e9c3
1 parent 7943dad
commit b36e9c3
Showing 1 changed file with 3 additions and 2 deletions.
diff --git a/docs/package_json.md b/docs/package_json.md
@@ -567,8 +567,9 @@ Scripts listed in this array will be required in each project of the workspace.
 
 ## resolutions
 
-Same as [`pnpm.overrides`]. We read it for easier migration from Yarn.
+Functionally identical to [`pnpm.overrides`], this field is intended to make it easier to migrate from Yarn.
+
+`resolutions` and `pnpm.overrides` get merged before package resolution (with `pnpm.overrides` taking precedence), which can be useful when you're migrating from Yarn and need to tweak a few packages just for pnpm.
 
 [pnpm patch-commit]: ./cli/patch-commit.md
 [`pnpm.overrides`]: #pnpmoverrides
-