WIP upgrade to v4 docs

Author: ericallam

docs/docs.json

@@ -18,14 +18,24 @@
         "groups": [
           {
             "group": "Getting started",
-            "pages": ["introduction", "quick-start", "video-walkthrough", "how-it-works", "limits"]
+            "pages": [
+              "introduction",
+              "quick-start",
+              "video-walkthrough",
+              "how-it-works",
+              "limits"
+            ]
           },
           {
             "group": "Fundamentals",
             "pages": [
               {
                 "group": "Tasks",
-                "pages": ["tasks/overview", "tasks/schemaTask", "tasks/scheduled"]
+                "pages": [
+                  "tasks/overview",
+                  "tasks/schemaTask",
+                  "tasks/scheduled"
+                ]
               },
               "triggering",
               "runs",
@@ -40,7 +50,12 @@
               "errors-retrying",
               {
                 "group": "Wait",
-                "pages": ["wait", "wait-for", "wait-until", "wait-for-token"]
+                "pages": [
+                  "wait",
+                  "wait-for",
+                  "wait-until",
+                  "wait-for-token"
+                ]
               },
               "queue-concurrency",
               "versioning",
@@ -84,7 +99,9 @@
           },
           {
             "group": "Development",
-            "pages": ["cli-dev"]
+            "pages": [
+              "cli-dev"
+            ]
           },
           {
             "group": "Deployment",
@@ -95,7 +112,9 @@
               "deployment/atomic-deployment",
               {
                 "group": "Deployment integrations",
-                "pages": ["vercel-integration"]
+                "pages": [
+                  "vercel-integration"
+                ]
               }
             ]
           },
@@ -146,15 +165,20 @@
           },
           {
             "group": "Using the Dashboard",
-            "pages": ["run-tests", "troubleshooting-alerts", "replaying", "bulk-actions"]
+            "pages": [
+              "run-tests",
+              "troubleshooting-alerts",
+              "replaying",
+              "bulk-actions"
+            ]
           },
           {
             "group": "Troubleshooting",
             "pages": [
               "troubleshooting",
               "troubleshooting-debugging-in-vscode",
               "upgrading-packages",
-              "upgrading-beta",
+              "upgrade-to-v4",
               "troubleshooting-uptime-status",
               "troubleshooting-github-issues",
               "request-feature"
@@ -172,7 +196,11 @@
           },
           {
             "group": "Help",
-            "pages": ["community", "help-slack", "help-email"]
+            "pages": [
+              "community",
+              "help-slack",
+              "help-email"
+            ]
           }
         ]
       },
@@ -193,7 +221,10 @@
           },
           {
             "group": "Tasks API",
-            "pages": ["management/tasks/trigger", "management/tasks/batch-trigger"]
+            "pages": [
+              "management/tasks/trigger",
+              "management/tasks/batch-trigger"
+            ]
           },
           {
             "group": "Runs API",
@@ -239,7 +270,9 @@
         "groups": [
           {
             "group": "Introduction",
-            "pages": ["guides/introduction"]
+            "pages": [
+              "guides/introduction"
+            ]
           },
           {
             "group": "Frameworks",
@@ -363,7 +396,10 @@
     "href": "https://trigger.dev"
   },
   "api": {
-    "openapi": ["openapi.yml", "v3-openapi.yaml"],
+    "openapi": [
+      "openapi.yml",
+      "v3-openapi.yaml"
+    ],
     "playground": {
       "display": "simple"
     }
@@ -538,4 +574,4 @@
       "destination": "/management/overview"
     }
   ]
-}
+}

docs/upgrade-to-v4.mdx

@@ -1,8 +1,93 @@
 ---
 title: "Upgrading to v4"
-description: "How to upgrade to v4."
+description: "What's new in v4, how to upgrade, and breaking changes."
 ---
 
-<Note>
-  Upgrading to v4 docs are coming soon.
-</Note>
+## What's new in v4?
+
+Link to blog post here
+
+- New Run Engine
+- Wait tokens
+- Upgraded Dashboard
+- Wait idempotency
+- Priority
+- Queues
+- New global lifecycle hooks
+- onPause and onResume
+- Improved middleware
+- locals
+- Improved tracing
+- MCP Server
+- Exporting tasks or queues
+
+## Installation
+
+To opt-in to using v4, you will need to update your dependencies to the latest version of the `v4` tag.
+
+<CodeGroup>
+
+```bash npm
+npm add @trigger.dev/sdk@v4
+```
+
+```bash yarn
+yarn add @trigger.dev/sdk@v4
+```
+
+```bash pnpm
+pnpm add @trigger.dev/sdk@v4
+```
+
+</CodeGroup>
+
+You'll also need to use the `v4` version of the `trigger.dev` CLI package:
+
+<CodeGroup>
+
+```bash npx
+npx trigger.dev@v4 dev
+```
+
+```bash yarn
+yarn dlx trigger.dev@v4 dev
+```
+
+```bash pnpm
+pnpm dlx trigger.dev@v4 dev
+```
+
+</CodeGroup>
+
+Or you could install the CLI into your `devDependencies` and then use the `trigger` binary:
+
+```json package.json
+{
+  "devDependencies": {
+    "trigger.dev": "v4"
+  },
+  "scripts": {
+    "dev": "trigger dev"
+  }
+}
+```
+
+## Deprecations
+
+### Import `@trigger.dev/sdk`
+
+### toolTask
+
+## Breaking changes
+
+### Queue changes
+
+### `releaseConcurrency`
+
+### Lifecycle hooks
+
+### Context changes
+
+## Migrating to the new run engine
+
+New runs after you deploy with