diff --git a/doc/languages-frameworks/javascript.section.md b/doc/languages-frameworks/javascript.section.md
index 9acfd4181108a5..eeb988adc4755c 100644
--- a/doc/languages-frameworks/javascript.section.md
+++ b/doc/languages-frameworks/javascript.section.md
@@ -594,6 +594,24 @@ To install the package `yarnInstallHook` uses both `npm` and `yarn` to cleanup p
 
 - `yarnKeepDevDeps`: Disables the removal of devDependencies from `node_modules` before installation.
 
+#### Use with `yarn-berry` and newer lockfiles {#javascript-yarnberry}
+
+The above works well with `yarn` version 1. However, `yarn-berry` introduced a new version of lockfiles, which will not work with classic `yarn`. To still be able to use `fetchYarnDeps` with `yarn-berry`, you will need to supply the source folder containing the `yarn.lock`  and the corresponding project files, and the version of the lockfile:
+
+```nix
+yarnOfflineCache = fetchYarnDeps {
+    src = "${src}/web";
+    yarnVersion = 3;
+    hash = "...";
+  };
+```
+
+`yarnVersion = 3` is for `yarn-berry_3` lockfiles and `yarnVersion = 4` will use `yarn-berry_4` to generate `node_modules`.
+
+The hook to be used with `yarn-berry` is called `yarnBerry3ConfigHook` for version 3 lockfiles and `yarnBerry4ConfigHook` for version 4 lockfiles.
+
+There is currently neither an `yarnBuildHook` nor an `yarnInstallHook` for `yarn-berry`.
+
 ### yarn2nix {#javascript-yarn2nix}
 
 WARNING: The `yarn2nix` functions have been deprecated in favor of the new `yarnConfigHook`, `yarnBuildHook` and `yarnInstallHook`. Documentation for them still appears here for the sake of the packages that still use them. See also a tracking issue [#324246](https://github.com/NixOS/nixpkgs/issues/324246).
diff --git a/doc/redirects.json b/doc/redirects.json
index a5a8769618482d..48893877f07770 100644
--- a/doc/redirects.json
+++ b/doc/redirects.json
@@ -3032,6 +3032,9 @@
   "javascript-yarninstallhook": [
     "index.html#javascript-yarninstallhook"
   ],
+  "javascript-yarnberry": [
+    "index.html#javascript-yarnberry"
+  ],
   "javascript-yarn2nix": [
     "index.html#javascript-yarn2nix"
   ],