(ci): Trigger docs site deployments.

.github/workflows/deploy-docs-site.yml

@@ -0,0 +1,44 @@
+name: Deploy docs
+
+env:
+  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+  pull_request:
+    paths:
+      - "docs/**"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Install Vercel CLI
+        run: npm install --global vercel@latest
+
+      - name: Create preview deployment
+        run: vercel deploy --cwd=docs --token=${{ secrets.VERCEL_TOKEN }}
+
+  deploy-production:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Install Vercel CLI
+        run: npm install --global vercel@latest
+
+      - name: Create production deployment
+        run: vercel deploy --cwd=docs --token=${{ secrets.VERCEL_TOKEN }}

docs/repo-docs/guides/ci-vendors/circleci.mdx

@@ -35,6 +35,7 @@ And a `turbo.json`:
 ```json title="./turbo.json"
 {
   "$schema": "https://turbo.build/schema.json",
+  "globalPassThroughEnv": ["CIRCLECI", "CIRCLE_*"],
   "tasks": {
     "build": {
       "outputs": [".next/**", "!.next/cache/**"],
@@ -45,6 +46,10 @@ And a `turbo.json`:
     }
   }
 }
+
+<Callout type="info">
+Note the `globalPassThroughEnv` configuration. This allows CircleCI's environment variables into the task's runtime when using [Strict Mode](https://turbo.build/repo/docs/crafting-your-repository/using-environment-variables#strict-mode).
+</Callout>
 ```
 
 Create a file called `.circleci/config.yml` in your repository with the following contents: