Skip to content

docs: replace migration guides with a Comparisons section#2676

Open
pranaygp wants to merge 1 commit into
mainfrom
docs/competition
Open

docs: replace migration guides with a Comparisons section#2676
pranaygp wants to merge 1 commit into
mainfrom
docs/competition

Conversation

@pranaygp

@pranaygp pranaygp commented Jun 26, 2026

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-guidescomparisons).

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):

Page v4 v5
Comparisons (index) v4 v5
vs Temporal v4 v5
vs Cloudflare Workflows v4 v5
vs AWS Step Functions v4 v5
vs AWS Bedrock AgentCore v4 v5
vs Inngest v4 v5
vs trigger.dev v4 v5

🤖 Generated with Claude Code

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 owners June 26, 2026 23:08
Copilot AI review requested due to automatic review settings June 26, 2026 23:08
@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Jun 26, 2026 11:11pm
example-nextjs-workflow-webpack Ready Ready Preview, Comment Jun 26, 2026 11:11pm
example-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-astro-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-express-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-fastify-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-hono-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-nitro-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-nuxt-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-sveltekit-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-tanstack-start-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workbench-vite-workflow Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workflow-docs Ready Ready Preview, Comment, Open in v0 Jun 26, 2026 11:11pm
workflow-swc-playground Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workflow-tarballs Ready Ready Preview, Comment Jun 26, 2026 11:11pm
workflow-web Ready Ready Preview, Comment Jun 26, 2026 11:11pm

@changeset-bot

changeset-bot Bot commented Jun 26, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: e3837f4

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

Copilot AI 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants