diff --git a/docs/getting-started.md b/docs/getting-started.md
index 6de8da2f92a16f0..3cd0ab18d173f17 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -41,6 +41,8 @@ npm install next react react-dom
 yarn add next react react-dom
 ```
 
+> **Note**: [Yarn 2](https://yarnpkg.com/getting-started/install) is supported as best-effort within Next.js. For best results, use NPM or Yarn 1.
+
 Open `package.json` and add the following `scripts`:
 
 ```json