docs: Upgrade to v4 guide (#1873)

* WIP upgrade to v4 docs

* WIP

* Upgrade to v4 docs

* Add wait for token docs and improve upgrade guide

* Added known issues to upgrade guide, and moved the migration section higher up

* Update to say "There are no known issues at the moment.”

* Docs upgrade guide package version. Need to use exact packages for the CLI to work

---------

Co-authored-by: Matt Aitken <[email protected]>

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",
@@ -364,7 +397,10 @@
     "href": "https://trigger.dev"
   },
   "api": {
-    "openapi": ["openapi.yml", "v3-openapi.yaml"],
+    "openapi": [
+      "openapi.yml",
+      "v3-openapi.yaml"
+    ],
     "playground": {
       "display": "simple"
     }
@@ -539,4 +575,4 @@
       "destination": "/management/overview"
     }
   ]
-}
+}

docs/snippets/upgrade-to-v4-note.mdx

@@ -0,0 +1,4 @@
+<Note>
+  This feature is only available in the v4 beta. To upgrade to v4, see the [upgrade to v4
+  docs](/upgrade-to-v4).
+</Note>