Restructure the Go, Python, and TypeScript Worker pages - #4980
Merged
Conversation
Gives all three pages the same six sections, ordered by the reader's journey: create and run, register types, connect to Cloud, configure options, run a versioned Worker, shut down. - Adds a versioned Worker section. None of the eight SDK Worker pages documented Worker Versioning. - Replaces hand-written inline code with snipsync snippets. - Un-nests the TypeScript register-types section, which was an H3 inside the Temporal Cloud section. - Replaces the TypeScript mTLS-only Cloud walkthrough with a pointer to the Client page, which also covers API keys. - Fills out the Python page, previously a single section. Existing anchor IDs are preserved because eight other pages link to them. The TypeScript Docker section is unchanged, moved after the core sections.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📖 Docs PR preview links
|
lennessyy
marked this pull request as ready for review
July 28, 2026 21:03
Duncanma
approved these changes
Jul 28, 2026
lennessyy
added a commit
that referenced
this pull request
Jul 31, 2026
Follow-up to #4980, applying the same pass done for the other four SDKs. - Python: the shutdown snippet used interrupt_event, which the page never defined. The SNIPSTART boundary in the features repo excludes the enclosing function that declares it. Adds the entry point that sets the event. - Python: run() installs no signal handlers and polls until shutdown() is called, so "the Worker runs until the process is interrupted" was inaccurate. - TypeScript: lowercase the operating system signals. Signal is a Temporal core term, so the capitalized form read as a Workflow Signal. - TypeScript: drop the paragraph in the first section that restated the registration rule the next section already states, and document per-Workflow versioningBehavior through setWorkflowOptions. - Go: document DefaultVersioningBehavior, that it requires UseVersioning, and that a Workflow with no behavior fails at registration time. - Go: name the Worker instead of "It" in the shutdown section.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Update the run worker page across Go, Python, and TS. This is to make the content more consistent and reference-able for the Serverless worker page for Cloud run. I will follow up with changes to other languages after Cloud Run release and we get more
Dependencies
Snippet bodies are committed inline, so nothing renders broken, but these must merge before a plain
yarn snipsyncreproduces this content:helloworld/worker/main.goThat last one turned up while writing this:
typescript-hello-workerwas defined in three files, and snipsync silently resolved it tosleep-for-daysinstead ofhello-world.Verification
yarn buildpasses, confirming every preserved anchor still resolves for its inbound links.vale --config .vale-ci.inireports 0 errors and 0 warnings; the single suggestion flags "Alpine" in pre-existing content.Follow-ups