diff --git a/docs/setup.mdx b/docs/setup.mdx
index 5add72796..bf52474aa 100644
--- a/docs/setup.mdx
+++ b/docs/setup.mdx
@@ -26,7 +26,7 @@ To use Bref, you will need an AWS account and the `serverless` CLI. Let's get st
     npm install -g serverless@3
     ```
 
-    Bref is compatible with Serverless Framework v3 and v4. However the Bref documentation is written for v3 as v4 switches to a proprietary license.
+    Bref is compatible with Serverless Framework v3 and v4. Note that Serverless Framework v4 has proven to be very unstable and is no longer open-source. We recommend using v3 for the best experience.
 
     If you don't want to install `serverless` via NPM, you can install it as a standalone binary [by following this documentation](https://github.com/serverless/serverless/blob/v3/docs/install-standalone.md).
 
diff --git a/docs/upgrading/v2.md b/docs/upgrading/v2.md
index 4921827bb..042394853 100644
--- a/docs/upgrading/v2.md
+++ b/docs/upgrading/v2.md
@@ -33,7 +33,7 @@ To check your Serverless Framework version, run:
 serverless --version
 ```
 
-If you need to upgrade, [read the Serverless Framework documentation](https://www.serverless.com/framework/docs/getting-started#upgrade) (short version: run `npm install -g serverless`).
+If you need to upgrade, [read the Serverless Framework documentation](https://www.serverless.com/framework/docs/getting-started#upgrade) (short version: run `npm install -g serverless@3`).
 
 ## PHP runtimes