Skip to content

Commit ffefbbc

Browse files
[docs] Polish migration guides for scanability (#1721)
Co-authored-by: Peter Wielander <mittgfu@gmail.com>
1 parent 4edf581 commit ffefbbc

9 files changed

Lines changed: 918 additions & 1161 deletions

File tree

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,34 @@
11
---
22
title: Migration Guides
3-
description: Move your existing durable workflow system to the Workflow SDK with side-by-side code comparisons and realistic migration examples.
3+
description: Move your existing durable workflow system to the Workflow SDK with side-by-side code comparisons and a realistic migration example.
44
type: overview
5-
summary: Migrate from Temporal, Inngest, or AWS Step Functions to the Workflow SDK.
5+
summary: Migrate from Temporal, Inngest, AWS Step Functions, or trigger.dev to the Workflow SDK.
66
related:
77
- /docs/foundations/workflows-and-steps
88
- /docs/getting-started
99
---
1010

11-
Migrate your existing orchestration system to the Workflow SDK. Each guide includes concept mappings, side-by-side code comparisons, and a full end-to-end migration example.
11+
<Callout type="info">
12+
Install the Workflow SDK migration skill:
13+
14+
```bash
15+
npx skills add https://github.com/vercel/workflow --skill migrating-to-workflow-sdk
16+
```
17+
</Callout>
18+
19+
Move an existing orchestration system to the Workflow SDK. Each guide pairs a concept-mapping table with side-by-side code, so you can translate one piece of your codebase at a time.
1220

1321
<Cards>
1422
<Card href="/docs/migration-guides/migrating-from-temporal" title="Migrating from Temporal">
15-
Replace Activities, Workers, Signals, and Child Workflows with Workflows, Steps, Hooks, and start()/getRun().
23+
Map Activities, Workers, Signals, and Child Workflows onto workflows, steps, hooks, and `start()` / `getRun()`.
1624
</Card>
1725
<Card href="/docs/migration-guides/migrating-from-inngest" title="Migrating from Inngest">
18-
Replace createFunction, step.run(), step.sleep(), step.waitForEvent(), and step.invoke() with Workflows, Steps, and Hooks.
26+
Map `createFunction`, `step.run`, `step.sleep`, `step.waitForEvent`, and `step.invoke` onto workflows, steps, and hooks.
1927
</Card>
2028
<Card href="/docs/migration-guides/migrating-from-aws-step-functions" title="Migrating from AWS Step Functions">
21-
Replace JSON state definitions, Task/Choice/Wait/Parallel states, and .waitForTaskToken callbacks with idiomatic TypeScript.
29+
Replace ASL JSON states, Task / Choice / Wait / Parallel states, and `.waitForTaskToken` callbacks with TypeScript.
30+
</Card>
31+
<Card href="/docs/migration-guides/migrating-from-trigger-dev" title="Migrating from trigger.dev">
32+
Map `task()`, `schemaTask()`, `wait.for` / `wait.forToken`, `triggerAndWait`, and `metadata.stream` onto workflows, steps, hooks, and `start()` / `getRun()`.
2233
</Card>
2334
</Cards>

docs/content/docs/migration-guides/meta.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
"pages": [
44
"migrating-from-temporal",
55
"migrating-from-inngest",
6-
"migrating-from-aws-step-functions"
6+
"migrating-from-aws-step-functions",
7+
"migrating-from-trigger-dev"
78
]
89
}

0 commit comments

Comments
 (0)