From 18c9a9bcd727ee3884c7d22a8cf89571c0df2f30 Mon Sep 17 00:00:00 2001 From: James Ritchie Date: Tue, 1 Apr 2025 16:41:32 +0100 Subject: [PATCH 1/4] Delete old wait-for pages & create new wait-for-token page --- docs/docs.json | 2 +- docs/wait-for-event.mdx | 8 -------- docs/wait-for-request.mdx | 8 -------- docs/wait-for-token.mdx | 10 ++++++++++ docs/wait.mdx | 7 +++---- 5 files changed, 14 insertions(+), 21 deletions(-) delete mode 100644 docs/wait-for-event.mdx delete mode 100644 docs/wait-for-request.mdx create mode 100644 docs/wait-for-token.mdx 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/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" - - 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" - - 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. + + 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 -| 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. | From 67bbf713779ca7210a2161deb0df7e3209f46b0d Mon Sep 17 00:00:00 2001 From: James Ritchie Date: Tue, 1 Apr 2025 16:41:46 +0100 Subject: [PATCH 2/4] Link to new wait-for-token page and update description --- apps/webapp/app/components/BlankStatePanels.tsx | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) 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={ - + Waitpoint docs } > - Waitpoint tokens are used to pause runs until you complete the token so the run can - continue. - - - 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. ); From 61b85f85a1d5c162cc918f3e9eb045de5f4c73ca Mon Sep 17 00:00:00 2001 From: James Ritchie Date: Tue, 1 Apr 2025 16:48:24 +0100 Subject: [PATCH 3/4] Adds an upgrade to v4 coming soon docs page --- docs/upgrade-to-v4.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 docs/upgrade-to-v4.mdx diff --git a/docs/upgrade-to-v4.mdx b/docs/upgrade-to-v4.mdx new file mode 100644 index 0000000000..6b7b3b53ad --- /dev/null +++ b/docs/upgrade-to-v4.mdx @@ -0,0 +1,8 @@ +--- +title: "Upgrading to v4" +description: "How to upgrade to v4." +--- + + + Upgrading to v4 docs are coming soon. + From ba547bd85199690d66086c6b2ae8a6c3cd799f2f Mon Sep 17 00:00:00 2001 From: James Ritchie Date: Tue, 1 Apr 2025 16:58:26 +0100 Subject: [PATCH 4/4] Removes unncessary property from Note component --- docs/upgrade-to-v4.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/upgrade-to-v4.mdx b/docs/upgrade-to-v4.mdx index 6b7b3b53ad..5c23b360bf 100644 --- a/docs/upgrade-to-v4.mdx +++ b/docs/upgrade-to-v4.mdx @@ -3,6 +3,6 @@ title: "Upgrading to v4" description: "How to upgrade to v4." --- - + Upgrading to v4 docs are coming soon.