diff --git a/docs/getting-started-installation.md b/docs/getting-started-installation.md
index 63c3eadc42..83b60bede5 100644
--- a/docs/getting-started-installation.md
+++ b/docs/getting-started-installation.md
@@ -6,6 +6,8 @@ description: Docusaurus was designed from the ground up to be easily installed a
 
 Docusaurus was designed from the ground up to be easily installed and used to get your website up and running quickly.
 
+> **Important Note:** If you are setting up a new Docusaurus website for a Facebook Open Source project, we highly encourage you to use [Docusaurus 2](https://v2.docusaurus.io) instead.
+
 ## Installing Docusaurus
 
 We have created a helpful script that will get all of the infrastructure set up for you:
diff --git a/website-1.x/pages/en/index.js b/website-1.x/pages/en/index.js
index 4fca823a94..cde63cf182 100644
--- a/website-1.x/pages/en/index.js
+++ b/website-1.x/pages/en/index.js
@@ -62,12 +62,14 @@ class Index extends React.Component {
         <HomeSplash siteConfig={siteConfig} language={language} />
         <div className="announcement">
           <div className="announcement-inner">
-            We're working on{' '}
-            <a href="https://github.com/facebook/docusaurus/issues/789">
-              Docusaurus 2
+            If you don't need advanced features such as versioning or
+            translations, try out
+            <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead!
+            Contribute to its roadmap by suggesting features or{' '}
+            <a href="https://v2.docusaurus.io/feedback/">
+              giving feedback here
             </a>
-            , contribute to its roadmap by suggesting features or giving
-            feedback <a href="https://v2.docusaurus.io/feedback/">here</a>!
+            !
           </div>
         </div>
         <div className="mainContainer">
diff --git a/website/docs/installation.md b/website/docs/installation.md
index a98051d0c7..d21db177e2 100644
--- a/website/docs/installation.md
+++ b/website/docs/installation.md
@@ -26,6 +26,12 @@ npx @docusaurus/init@next init my-website classic
 
 If you do not specify `name` or `template`, it will prompt you for them. We recommend the `classic` template so that you can get started quickly and it contains features found in Docusaurus 1. The `classic` template contains `@docusaurus/preset-classic` which includes standard documentation, a blog, custom pages, and a CSS framework (with dark mode support). You can get up and running extremely quickly with the classic template and customize things later on when you have gained more familiarity with Docusaurus.
 
+**Important Note:** If you are setting up a new Docusaurus website for a Facebook open source project, use the `facebook` template instead, which comes with some useful Facebook-specific defaults:
+
+```bash
+npx @docusaurus/init@next init my-website facebook
+```
+
 ## Project structure
 
 Assuming you chose the classic template and named your site `my-website`, you will see the following files generated under a new directory `my-website/`: