diff --git a/web/README.md b/web/README.md
index fe5d419dbb8..36eb1fb25db 100644
--- a/web/README.md
+++ b/web/README.md
@@ -32,8 +32,8 @@ yarn dev
 
 That's it. The web app will automatically hot reload when you make changes.
 
-If you're new to web development and unsure about how to get started, see
-[docs/new](docs/new.md).
+If you're new to web development and unsure about how to get started,  or are
+facing some problems when running the above steps, see [docs/new](docs/new.md).
 
 ## Other apps
 
diff --git a/web/docs/new.md b/web/docs/new.md
index a393066fe35..e820257a33c 100644
--- a/web/docs/new.md
+++ b/web/docs/new.md
@@ -13,3 +13,14 @@ development, here is a recommended workflow:
    `yarn` comes with it.
 
 That's it. Enjoy coding!
+
+### Yarn
+
+Note that we use Yarn classic
+
+```
+$ yarn --version
+1.22.21
+```
+
+You should be seeing a 1.xx.xx version, otherwise your `yarn install` will fail.