') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); docs: replace migration guides with a Comparisons section by pranaygp · Pull Request #2676 · vercel/workflow · GitHub
Skip to content

docs: replace migration guides with a Comparisons section - #2676

Merged
pranaygp merged 9 commits into
mainfrom
docs/competition
Jul 21, 2026
Merged

docs: replace migration guides with a Comparisons section#2676
pranaygp merged 9 commits into
mainfrom
docs/competition

Conversation

@pranaygp

@pranaygppranaygp commented Jun 26, 2026•
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

Replaces the migration-guides docs section with a new Comparisons section in both v4 and v5.

  • Index (/docs/comparisons) — positioning, a snapshot table across all seven (Workflow SDK + 6 alternatives), a "not a benchmark" caveat, and cards to each deep dive.
  • Six deep-dive pages — Workflow SDK vs Temporal, Cloudflare Workflows, AWS Step Functions, AWS Bedrock AgentCore, Inngest, and trigger.dev — each a 2-way comparison across execution model, where it runs, versioning, AI-SDK / streaming fit, security, performance, portability, pricing, limits, and maturity.
  • The useful parts of the old migration guides (concept-mapping tables, key code, "features without a 1:1 equivalent", the migration-skill pointer) are folded into the relevant comparison pages. The four guides that existed (Temporal, Inngest, Step Functions, trigger.dev) are removed; Cloudflare Workflows and AgentCore are net-new.
  • Top-level nav updated in both versions (migration-guides → comparisons).

Notes

  • Docs-only change.pnpm changeset status --since=main reports no changeset needed (content under docs/content/ isn't mapped to a package), and the changeset bot confirms no version bump.
  • Comparisons are compiled from each product's public docs as of June 2026 and are explicitly not head-to-head benchmarks — each page is date-stamped and says so.
  • Verified against the docs link-checker rules (internal links + Card hrefs resolve in both URL spaces, frontmatter refs resolve, the section landing page cards all its children, and every meta.json entry resolves). The workflow-docs preview built successfully (full next build passed).

Docs Preview

On the workflow-docs deployment (behind Vercel team auth):

Pagev4v5
Comparisons (index)v4v5
vs Temporalv4v5
vs Cloudflare Workflowsv4v5
vs AWS Step Functionsv4v5
vs AWS Bedrock AgentCorev4v5
vs Inngestv4v5
vs trigger.devv4v5

🤖 Generated with Claude Code

@pranaygp@claude
docs: replace migration guides with a Comparisons section
e3837f4
Add a Comparisons section (v4 + v5) with an index/snapshot across all frameworks and deep-dive pages for Temporal, Cloudflare Workflows, AWS Step Functions, AWS Bedrock AgentCore, Inngest, and trigger.dev. Remove the old migration-guides section, folding its concept-mapping and migration content into the relevant comparison pages, and repoint top-level nav in both versions.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@pranaygp
pranaygp requested review from a team and ijjk as code ownersJune 26, 2026 23:08
CopilotAI review requested due to automatic review settings June 26, 2026 23:08
@vercel

vercelBot commented Jun 26, 2026•
edited
Loading

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
example-nextjs-workflow-turbopackReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
example-nextjs-workflow-webpackReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
example-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-astro-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-express-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-fastify-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-hono-workflowBuildingBuildingPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-nestjs-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-nitro-workflowBuildingBuildingPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-nuxt-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-sveltekit-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-tanstack-start-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workbench-vite-workflowReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workflow-docsReadyReadyPreview, 💬 2 unresolved
✅ 9 resolved, Open in v0		Jul 21, 2026 11:17am
workflow-swc-playgroundReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workflow-tarballsReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am
workflow-webReadyReadyPreview, Comment, Open in v0Jul 21, 2026 11:17am

@changeset-bot

changeset-botBot commented Jun 26, 2026•
edited
Loading

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 373143b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

CopilotAI reviewed Jun 26, 2026

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@VaguelySerious

VaguelySerious commented Jul 15, 2026

Copy link
Copy Markdown
Member

We should revive this PR!

@VaguelySerious
Merge remote-tracking branch 'origin/main' into docs/competition
4466c1c
# Conflicts:
#	docs/content/docs/v4/migration-guides/migrating-from-aws-step-functions.mdx
#	docs/content/docs/v4/migration-guides/migrating-from-inngest.mdx
#	docs/content/docs/v4/migration-guides/migrating-from-temporal.mdx
#	docs/content/docs/v4/migration-guides/migrating-from-trigger-dev.mdx
#	docs/content/docs/v5/meta.json
#	docs/content/docs/v5/migration-guides/migrating-from-aws-step-functions.mdx
#	docs/content/docs/v5/migration-guides/migrating-from-inngest.mdx
#	docs/content/docs/v5/migration-guides/migrating-from-temporal.mdx
#	docs/content/docs/v5/migration-guides/migrating-from-trigger-dev.mdx
@VaguelySerious
VaguelySerious requested a review from a team as a code ownerJuly 16, 2026 20:20
@vercel

vercelBot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Deployment failed with the following error:

Creating the Deployment Timed Out.

VaguelySeriousand others added 2 commits July 16, 2026 14:52
@VaguelySerious@claude
docs: tighten comparison maturity/status wording
cfd0712
- Drop dateless "upcoming change" phrasing: AgentCore compliance now states
current facts only (no "self-assessed"/audit-pending implication); remove
Inngest's "SSPL → Apache after 3 yrs" license-conversion note.
- Don't label the Workflow SDK "GA" — non-beta is the default; also drop bare
"GA" where it only meant "not beta" (Temporal "7 SDKs", Inngest "TypeScript",
competitor maturity cells).
- Maturity cells no longer cite version numbers; they describe backing/track
record instead (e.g. "Built and maintained by Vercel", "Backed by AWS").
v4 and v5 kept identical.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@VaguelySerious@claude
docs: make "features without a 1:1 equivalent" sections directional
95f64a8
Rename each heading to name the competitor that has the feature (e.g.
"Temporal features without a direct Workflow SDK equivalent") and add a
lead-in clarifying these are the competitor's capabilities the Workflow SDK
doesn't replicate one-to-one, with how to cover each on the Workflow SDK side.
v4 and v5 kept identical.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
VaguelySerious
VaguelySerious approved these changes Jul 16, 2026
View reviewed changes

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Revived/updated/reviewed the PR

@pranaygp@claude
docs: point world links at the /worlds routes
56bfdf5
The comparison pages linked to /docs/deploying/world/* and
/docs/deploying/building-a-world, which no longer exist in the docs
trees (the Docs Links check rejects them on v5 pages, where /docs hrefs
are render-rewritten and skip the legacy redirects). Link the canonical
/worlds/* routes directly, in both body links and frontmatter refs.
v4 and v5 kept identical.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
pranaygpand others added 2 commits July 21, 2026 13:08
@pranaygp
Merge remote-tracking branch 'origin/main' into docs/competition
f7a526c
* origin/main: (21 commits)
docs(agents): note lint/format/typecheck are advisory, not blocking (#2886)
Retry transient connection timeouts (#3013)
fix(world-vercel): append caller User-Agent products instead of discarding them (#2998)
[ci] Enable NestJS e2e-vercel-prod and add to docs as "experimental" (#3011)
[ci] Benchmark comment: Best column + best/p75/p99 deltas (drop Avg/P10) (#3005)
docs: fall back to first child page for sidebar folders without an index (#3009)
[nest] Fix NestJS Vercel build output (#2988)
Avoid resolving run data for background steps (#2993)
chore(docs): update @vercel/geistdocs to 1.14.0 (#3002)
fix(docs): add version-switcher fallback redirects for pages missing in one version (#3003)
ci: update opencode to 1.18.4 and switch backport AI model to claude-fable-5 (#3006)
fix(core): batch stream writes via writeMulti (#2995)
perf(core): cache port discovery in step invocations for self-hosted worlds (#2996)
feat(web-shared): Alt+hover span measurement in the new trace viewer (#2985)
fix(world-postgres): throw EntityConflictError on duplicate run_created (#2983)
[ci] Run benchmarks in-deployment to avoid proxy overhead (#2967)
Enable additional perf optimizations when correctness guarantees are met (#2970)
perf(core): prepare replay payloads concurrently (#2980)
Fix dotted tsconfig alias workflow discovery (#2963)
Adjust helper position on trace viewer (#2968)
...
@pranaygp@claude
docs: address toolbar review feedback on the comparison pages
373143b
- Drop the Maturity row from every at-a-glance table
- Add a "what the limits mean in practice" paragraph to each comparison,
spelling out what the competitor's caps mean for long-running AI
workloads, and link Vercel World limits to the pricing doc
- Security cells: lead with zero-config per-run E2E encryption and note
platform security is per-World, instead of the VM-sandbox framing
- Temporal: drop the throughput sentence and the still-in-preview
Serverless Workers mention from the performance cell
- Cloudflare: end the recommendation on "already all-in on Cloudflare"
- Convert the "features without a direct equivalent" bullet lists into
two-column tables so it's unambiguous which product owns each feature
- Fix the Inngest page's "no step cap" cell (Vercel World caps runs at
10K steps per the pricing doc)
v4 and v5 kept identical.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actionsgithub-actionsBot mentioned this pull request Jul 21, 2026
Closed
@github-actions

github-actionsBot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Backport PR opened against stable: #3029. Merge conflicts were resolved by AI — please review carefully. (backport job run)

@pranaygppranaygp mentioned this pull request Jul 27, 2026
Merged
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code reviewCopilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@VaguelySeriousVaguelySeriousVaguelySerious approved these changes
@ijjkijjkAwaiting requested review from ijjk

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@pranaygp@VaguelySerious