diff --git a/apps/webapp/app/components/BlankStatePanels.tsx b/apps/webapp/app/components/BlankStatePanels.tsx
index 55c984b951..b03959387d 100644
--- a/apps/webapp/app/components/BlankStatePanels.tsx
+++ b/apps/webapp/app/components/BlankStatePanels.tsx
@@ -419,17 +419,15 @@ export function NoWaitpointTokens() {
       iconClassName="text-sky-500"
       panelClassName="max-w-md"
       accessory={
-        <LinkButton to={docsPath("wait")} variant="docs/small" LeadingIcon={BookOpenIcon}>
+        <LinkButton to={docsPath("wait-for-token")} variant="docs/small" LeadingIcon={BookOpenIcon}>
           Waitpoint docs
         </LinkButton>
       }
     >
       <Paragraph spacing variant="small">
-        Waitpoint tokens are used to pause runs until you complete the token so the run can
-        continue.
-      </Paragraph>
-      <Paragraph spacing variant="small">
-        You can build approval workflows using them, as well as other use cases.
+        Waitpoint tokens pause task runs until you complete the token. They're commonly used for
+        approval workflows and other scenarios where you need to wait for external confirmation,
+        such as human-in-the-loop processes.
       </Paragraph>
     </InfoPanel>
   );
diff --git a/docs/docs.json b/docs/docs.json
index 86392bbad8..14bd127e8f 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -40,7 +40,7 @@
               "errors-retrying",
               {
                 "group": "Wait",
-                "pages": ["wait", "wait-for", "wait-until", "wait-for-event", "wait-for-request"]
+                "pages": ["wait", "wait-for", "wait-until", "wait-for-token"]
               },
               "queue-concurrency",
               "versioning",
diff --git a/docs/upgrade-to-v4.mdx b/docs/upgrade-to-v4.mdx
new file mode 100644
index 0000000000..5c23b360bf
--- /dev/null
+++ b/docs/upgrade-to-v4.mdx
@@ -0,0 +1,8 @@
+---
+title: "Upgrading to v4"
+description: "How to upgrade to v4."
+---
+
+<Note>
+  Upgrading to v4 docs are coming soon.
+</Note>
diff --git a/docs/wait-for-event.mdx b/docs/wait-for-event.mdx
deleted file mode 100644
index 2e2b67c024..0000000000
--- a/docs/wait-for-event.mdx
+++ /dev/null
@@ -1,8 +0,0 @@
----
-title: "Wait for event"
-description: "Wait until an event has been received, then continue execution."
----
-
-import ComingSoon from "/snippets/coming-soon-in-review.mdx"
-
-<ComingSoon />
diff --git a/docs/wait-for-request.mdx b/docs/wait-for-request.mdx
deleted file mode 100644
index 59008eb0fc..0000000000
--- a/docs/wait-for-request.mdx
+++ /dev/null
@@ -1,8 +0,0 @@
----
-title: "Wait for request"
-description: "Wait until a `Request` has been received at the provided URL, then continue execution."
----
-
-import ComingSoon from "/snippets/coming-soon-in-review.mdx"
-
-<ComingSoon />
diff --git a/docs/wait-for-token.mdx b/docs/wait-for-token.mdx
new file mode 100644
index 0000000000..2370e12859
--- /dev/null
+++ b/docs/wait-for-token.mdx
@@ -0,0 +1,10 @@
+---
+title: "Wait for token"
+description: "Wait until a token is completed."
+---
+
+import ComingSoon from "/snippets/coming-soon-generic.mdx"
+
+Waitpoint tokens pause task runs until you complete the token. They're commonly used for approval workflows and other scenarios where you need to wait for external confirmation, such as human-in-the-loop processes.
+
+<ComingSoon />
diff --git a/docs/wait.mdx b/docs/wait.mdx
index 3738124564..af80c8cf02 100644
--- a/docs/wait.mdx
+++ b/docs/wait.mdx
@@ -10,9 +10,8 @@ Waiting allows you to write complex tasks as a set of async code, without having
 
 <PausedExecutionFree />
 
-| Function                                  | What it does                                                                              |
-| ----------------------------------------- | ----------------------------------------------------------------------------------------- |
+| Function                               | What it does                                                                              |
+| :--------------------------------------| :---------------------------------------------------------------------------------------- |
 | [wait.for()](/wait-for)                | Waits for a specific period of time, e.g. 1 day.                                          |
 | [wait.until()](/wait-until)            | Waits until the provided `Date`.                                                          |
-| [wait.forRequest()](/wait-for-request) | Waits until a matching HTTP request is received, and gives you the data to continue with. |
-| [waitForEvent()](/wait-for-event)      | Waits for a matching event, like in the example above.                                    |
+| [wait.forToken()](/wait-for-token)     | Pauses task runs until a token is completed.                                              |