Skip to content

worker versioning section refactor - #5038

Merged
jsundai merged 7 commits into
mainfrom
split-worker-versioning
Aug 7, 2026
Merged

worker versioning section refactor #5038
jsundai merged 7 commits into
mainfrom
split-worker-versioning

Conversation

@jsundai

@jsundai jsundai commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

  • Splits the super long Worker Versioning page into a main + subpages for short focused reading.
  • Groups related pages under the Worker Versioning sidebar category (recover pinned Workflows, unversioned → versioned migration). Infra pages (Worker Controller, EKS, Serverless) stay as siblings.

Scroll length:

  • Original page: ~21 scrolls (1079 lines / ~1062 body lines)
  • New pages: ~3–5 scrolls each (hub ~4)

Subpages:

  • Configure a Worker
  • Roll out and pin
  • Upgrade on Continue-as-New
  • Sunset and GC

Notes to reviewers

TODO: Links need to be checked. Double check all content is still the same and just reorganized.

┆Attachments: EDU-6891 worker versioning section refactor

@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview Aug 7, 2026 6:56pm

Request Review

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links


import { SdkTabs } from '@site/src/components';

## Sunsetting an old Deployment Version {/* #sunsetting-an-old-deployment-version */}

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Sunsetting an old Deployment Version *********************************************' should use sentence-style capitalization.


:::

### Default Versioning Behavior Considerations

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Default Versioning Behavior Considerations' should use sentence-style capitalization.


For a complete runbook covering batch recovery, drainage handling, and how to choose between Versioning Override and Reset-with-Move based on each Workflow's state, see [Recover pinned Workflows after a bad rollout](/production-deployment/worker-deployments/recover-pinned-workflows).

## Migrating a Workflow from Pinned to Auto-Upgrade

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Migrating a Workflow from Pinned to Auto-Upgrade' should use sentence-style capitalization.


import { SdkTabs, AnnotatedCode } from '@site/src/components';

## Upgrading on Continue-as-New {/* #upgrade-on-continue-as-new */}

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Upgrading on Continue-as-New ***********************************' should use sentence-style capitalization.

@jsundai
jsundai marked this pull request as ready for review August 7, 2026 15:29
@jsundai
jsundai requested a review from a team as a code owner August 7, 2026 15:29
Comment thread docs/production-deployment/worker-deployments/worker-versioning/index.mdx Outdated
@jsundai

jsundai commented Aug 7, 2026

Copy link
Copy Markdown
Contributor Author

I'll have to look into the redirect. It might be a false positive. The page URL is still the same.

@jsundai
jsundai merged commit e120a35 into main Aug 7, 2026
14 of 15 checks passed
@jsundai
jsundai deleted the split-worker-versioning branch August 7, 2026 18:59
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