Skip to content

Docs: Durable execution, part I#3387

Open
mrkaye97 wants to merge 15 commits intomainfrom
mk/durable-exec-docs
Open

Docs: Durable execution, part I#3387
mrkaye97 wants to merge 15 commits intomainfrom
mk/durable-exec-docs

Conversation

@mrkaye97
Copy link
Copy Markdown
Contributor

Description

Reworking the first batch of durable execution docs to try to simplify them, remove some redundancy, clarify some things, improve internal linking, etc.

Type of change

  • Documentation change (pure documentation change)

Copilot AI review requested due to automatic review settings March 24, 2026 20:34
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 24, 2026

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

Project Deployment Actions Updated (UTC)
hatchet-docs Ready Ready Preview, Comment Apr 3, 2026 7:50pm

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR restructures the “durable execution” documentation set by consolidating/renaming pattern pages, updating internal links, and refreshing some explanatory text so the “durable tasks vs DAGs” story is simpler and less redundant.

Changes:

  • Replaces older “Durable Execution” / “Best Practices” pattern pages with a new Durable Tasks page and an updated Workflow Design index.
  • Updates various docs links/navigation labels and search-quality expectations to reflect the new structure.
  • Updates SDK non-determinism error messages to point to the new docs location.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
sdks/typescript/src/util/errors/non-determinism-error.ts Updates durable-task expectations doc link in error text.
sdks/python/hatchet_sdk/exceptions.py Updates durable-task expectations doc link in error text.
frontend/docs/scripts/test-search-quality.ts Adjusts search test expectations for the new docs structure.
frontend/docs/pages/v1/tasks.mdx Adds SDK-specific clarification about task function signatures/args.
frontend/docs/pages/v1/task-eviction.mdx Updates links to determinism/durable-task docs.
frontend/docs/pages/v1/patterns/mixing-patterns.mdx Removes the old “Best Practices” page.
frontend/docs/pages/v1/patterns/index.mdx Rewrites the patterns landing page as “Workflow Design” and updates links.
frontend/docs/pages/v1/patterns/durable-tasks.mdx Adds the new consolidated Durable Tasks page.
frontend/docs/pages/v1/patterns/durable-task-execution.mdx Removes the old durable-task execution page.
frontend/docs/pages/v1/patterns/directed-acyclic-graphs.mdx Simplifies and renames sections/headings for the DAGs page.
frontend/docs/pages/v1/patterns/_meta.js Updates patterns nav metadata to new page keys/titles.
frontend/docs/pages/v1/durable-execution.mdx Updates internal linking to the new Durable Tasks page.
frontend/docs/pages/v1/conditions.mdx Updates determinism reference link to the new Durable Tasks page.
frontend/docs/pages/v1/child-spawning.mdx Rewrites intro/section titles and adjusts explanatory wording.
frontend/docs/pages/v1/_meta.js Renames sidebar section titles to match new information architecture.
frontend/docs/next.config.mjs Adjusts redirect for durable best practices.
frontend/docs/.gitignore Ignores tsconfig.tsbuildinfo for docs app.

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