[pull] master from facebook:master

.circleci/config.yml

@@ -81,22 +81,22 @@ jobs:
             if ! git diff-tree --no-commit-id --name-only -r HEAD | grep -E "(^docs\/.*)|(docusaurus-1\.x\/.*)|(website-1\.x\/.*)"; then
               echo "Skipping deploy. No relevant v1 website files have changed"
             elif [[ $CIRCLE_PROJECT_USERNAME == "facebook" && -z $CI_PULL_REQUEST && -z $CIRCLE_PR_USERNAME ]]; then
-              echo "Deploying website..."
+              echo "Deploying website v1..."
+              cd website-1.x
+
               # install Docusaurus and generate file of English strings
-              cd website-1.x && yarn run write-translations
-              # install Crowdin
-              sudo apt-get update
-              sudo apt-get install default-jre rsync
-              wget https://artifacts.crowdin.com/repo/deb/crowdin.deb -O crowdin.deb
-              sudo dpkg -i crowdin.deb
-              sleep 5
+              yarn run write-translations
+
               # upload translation strings and download translations
-              yarn run crowdin-upload
+              yarn crowdin-upload
+
               # download only enabled languages
-              for lang in fr ko ru ro pt-BR zh-CN
-              do
-                  yarn crowdin-download -l $lang
-              done
+              yarn crowdin-download
+              # for lang in fr ko ru ro pt-BR zh-CN
+              # do
+              #    yarn crowdin-download -l $lang
+              # done
+
               # publish
               GIT_USER=docusaurus-bot USE_SSH=false yarn run publish-gh-pages
             else
@@ -119,4 +119,4 @@ workflows:
       - deploy-website:
           requires:
             - tests
-          filters: *filter-only-master
+          filters: *filter-only-master

.devcontainer/devcontainer.json

@@ -0,0 +1,10 @@
+{
+  "name": "Docusaurus Dev Container",
+  "image": "mcr.microsoft.com/vscode/devcontainers/typescript-node:0-10-buster",
+  "settings": {
+    "terminal.integrated.shell.linux": "/bin/bash"
+  },
+  "extensions": ["dbaeumer.vscode-eslint"],
+  "forwardPorts": [3000],
+  "postCreateCommand": "yarn install"
+}

.eslintignore

@@ -1,33 +1,23 @@
 __fixtures__
 dist
 node_modules
+.yarn
 build
 coverage
 jest.config.js
 jest.transform.js
 website-1.x/
 website/
 scripts
+
+packages/docusaurus/lib/
+packages/docusaurus-*/lib/*
+!packages/docusaurus-1.x/lib/*
+packages/docusaurus-1.x/lib/core/__tests__/split-tab.test.js
 packages/docusaurus-1.x/lib/core/metadata.js
 packages/docusaurus-1.x/lib/core/MetadataBlog.js
-packages/docusaurus-1.x/lib/core/__tests__/split-tab.test.js
-packages/docusaurus-utils/lib/
-packages/docusaurus-utils-validation/lib/
-packages/docusaurus/lib/
-packages/docusaurus-init/lib/
-packages/docusaurus-plugin-client-redirects/lib/
-packages/docusaurus-plugin-content-blog/lib/
-packages/docusaurus-plugin-content-docs/lib/
-packages/docusaurus-plugin-content-pages/lib/
-packages/docusaurus-plugin-debug/lib/
-packages/docusaurus-plugin-sitemap/lib/
-packages/docusaurus-plugin-ideal-image/lib/
+packages/docusaurus-*/lib-next/
 packages/docusaurus-plugin-ideal-image/copyUntypedFiles.js
-packages/docusaurus-theme-common/lib/
-packages/docusaurus-theme-classic/lib/
-packages/docusaurus-theme-classic/lib-next/
-packages/docusaurus-theme-bootstrap/lib/
-packages/docusaurus-migrate/lib/
 
 packages/docusaurus-1.x/.eslintrc.js
 packages/docusaurus-init/templates/facebook/.eslintrc.js

.github/ISSUE_TEMPLATE/bug.md

@@ -4,6 +4,18 @@ about: Submit a bug report to help us improve
 labels: 'bug, needs triage'
 ---
 
+<!--
+
+  ! PLEASE HELP US HELP YOU !
+
+  Bugs are fixed faster if you include:
+  - a repro repository to inspect the code
+  - an url to see the problem live (if possible)
+
+  Pro tip: create a reproducible demo of the bug with https://new.docusaurus.io
+
+-->
+
 ## 🐛 Bug Report
 
 (A clear and concise description of what the bug is)
@@ -14,6 +26,8 @@ labels: 'bug, needs triage'
 
 ## To Reproduce
 
+If possible, use https://new.docusaurus.io to create a CodeSandbox reproducible demo of the bug.
+
 (Write your steps here:)
 
 1. Step 1...
@@ -45,13 +59,17 @@ labels: 'bug, needs triage'
 
 <!-- Include as many relevant details about the environment you experienced the bug in -->
 
+- Public source code:
+- Public site url:
 - Docusaurus version used:
 - Environment name and version (e.g. Chrome 78.0.3904.108, Node.js 10.17.0):
 - Operating system and version (desktop or mobile):
 
 ## Reproducible Demo
 
-(Paste the link to an example repo, including a `siteConfig.js`, and exact instructions to reproduce the issue.)
+If possible, use https://new.docusaurus.io to create a CodeSandbox reproducible demo of the bug.
+
+(Paste the link to an example repo, including a `docusaurus.config.js`, and exact instructions to reproduce the issue.)
 
 <!--
   What happens if you skip this step?

.github/ISSUE_TEMPLATE/question.md

@@ -1,15 +1,17 @@
 ---
-name: ❓ Questions/Help
-about: If you have questions, please check Stack Overflow or Discord or Twitter
+name: 🚫 Questions/Help
+about: 🚫 Please ask questions on GitHub discussions, Discord or Stack Overflow
 labels: 'questions, needs triage'
 ---
 
-## ❓ Questions and Help
+## 🚫 Questions and Help
 
-### Please note that this issue tracker is not a help form and this issue will be closed.
+### Please note that this issue tracker is 🚫 NOT a help form 🚫 and this issue will be closed.
 
-Please contact us instead. We have a few channels:
+For beginners questions: ask the Docusaurus community:
 
+- [Discord](https://discord.gg/docusaurus) (most active channel)
 - [Stack Overflow](https://stackoverflow.com/questions/tagged/docusaurus)
 - [Twitter](https://twitter.com/docusaurus)
-- [Discord](https://discord.gg/docusaurus)
+
+For advanced/unanswered questions: ask on [GitHub Discussions](https://github.com/facebook/docusaurus/discussions).

.github/workflows/build-size.yml

@@ -1,4 +1,4 @@
-name: Build Size
+name: Build Size Report
 
 on:
   pull_request_target:
@@ -8,12 +8,12 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v2
       - uses: preactjs/compressed-size-action@v2
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
-          pattern: '{website/build/main*js,website/build/styles*css,website/build/index.html,website/build/blog/**/introducing-docusaurus/*,website/build/docs/introduction/index.html}'
+          build-script: 'build:v2:en'
+          pattern: '{website/build/assets/js/main*js,website/build/assets/css/styles*css,website/build/index.html,website/build/blog/**/introducing-docusaurus/*,website/build/docs/introduction/index.html}'
           strip-hash: '\.([^;]\w{7})\.'
           minimum-change-threshold: 100

.github/workflows/canary-releases.yml

@@ -0,0 +1,53 @@
+name: Canary releases
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  checkPackagesHaveChanged:
+    runs-on: ubuntu-latest
+    outputs:
+      packagesHaveChanged: ${{ steps.filter.outputs.packagesHaveChanged }}
+    steps:
+      - uses: actions/checkout@v2
+      - uses: dorny/paths-filter@v2
+        id: filter
+        with:
+          filters: |
+            packagesHaveChanged:
+              - 'packages/**'
+
+  publish-canary:
+    needs: checkPackagesHaveChanged
+    if: ${{ needs.checkPackagesHaveChanged.outputs.packagesHaveChanged == 'true' }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [10.x]
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Prepare git
+        run: |
+          git config --global user.name "Docusaurus Canary"
+          git config --global user.email "canary@docusaurus.io"
+          git fetch
+          git checkout master
+          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" >> .npmrc
+          cat .npmrc
+          echo "npm whoami"
+          npm whoami
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+      - name: Installation
+        run: yarn
+      - name: Publish Canary release
+        run: |
+          yarn canary
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

.github/workflows/e2e-test.yml

@@ -1,8 +1,6 @@
 name: E2E Test
 
 on:
-  # Trigger the workflow on push or pull request,
-  # but only for the master branch
   push:
     branches:
       - master
@@ -15,13 +13,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [10.x]
+        node: ['10']
     steps:
-      - uses: actions/checkout@v1
-      - name: Use Node.js ${{ matrix.node-version }}
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node }}
         uses: actions/setup-node@v1
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version: ${{ matrix.node }}
       - name: Installation
         run: yarn
       - name: Setup test-website project against master release
@@ -40,13 +38,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [10.x]
+        node: ['14']
     steps:
-      - uses: actions/checkout@v1
-      - name: Use Node.js ${{ matrix.node-version }}
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node }}
         uses: actions/setup-node@v1
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version: ${{ matrix.node }}
       - name: Installation
         run: yarn
       - name: Setup test-website project against master release

.github/workflows/lighthouseCI.yml

@@ -1,26 +1,18 @@
-name: Lighthouse CI
+name: Lighthouse Report
 
 on: pull_request_target
 
 jobs:
   build:
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v2
-      - name: Use Node.js 12.x
-        uses: actions/setup-node@v1
-        with:
-          node-version: 12.x
-      - name: Install and Build
-        run: |
-          yarn install
-          yarn build
       - name: Wait for the Netlify Preview
         uses: jakepartusch/wait-for-netlify-action@v1
         id: netlify
         with:
           site_name: 'docusaurus-2'
+          max_timeout: 600
       - name: Audit URLs using Lighthouse
         id: lighthouse_audit
         uses: treosh/lighthouse-ci-action@v3

.github/workflows/migration-cli-e2e-test.yml

@@ -1,27 +1,35 @@
-name: MIGRATION CLI E2E TEST
+name: Migration CLI E2E Test
 
 on:
-  # Trigger the workflow on push or pull request,
-  # but only for the master branch
-  push:
-    branches:
-      - master
   pull_request:
     branches:
       - master
 
 jobs:
+  check:
+    runs-on: ubuntu-latest
+    outputs:
+      migration: ${{ steps.filter.outputs.migration }}
+    steps:
+      - uses: dorny/paths-filter@v2
+        id: filter
+        with:
+          filters: |
+            migration:
+              - 'packages/docusaurus-migration/**'
   build:
+    needs: check
+    if: ${{ needs.check.outputs.migration == 'true' }}
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [10.x]
+        node: ['10']
     steps:
-      - uses: actions/checkout@v1
-      - name: Use Node.js ${{ matrix.node-version }}
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node }}
         uses: actions/setup-node@v1
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version: ${{ matrix.node }}
       - name: Installation
         run: yarn
       - name: Migrate D1 website