diff --git a/docs/migrating.md b/docs/migrating.md
index 1d2ea5573..c8a3f9d97 100644
--- a/docs/migrating.md
+++ b/docs/migrating.md
@@ -40,6 +40,9 @@ git merge tags/v13.0.0-preview2 --squash
   # you are now on the "next" release
 ```
 
+## Making sure modern Yarn works
+Foundkey uses Yarn 3.2.3 instead of 1.x. To make sure the `yarn` command will work going forward, run `corepack enable`.
+
 ## Rebuilding and running database migrations
 This will be pretty much the same as a regular update of Misskey. Note that `yarn install` may take a while since dependency versions have been updated or removed and we use a newer version of Yarn.
 ```sh