Skip to content

Conversation

@bchav
Copy link

@bchav bchav commented Jan 28, 2026

Summary

  • Adds docs/task-queues.md explaining the relationship between TemporalWorkerDeployment and Task Queues
  • Documents the recommended pattern of one TWD per Task Queue
  • Includes FAQ addressing common questions

Why

Users are asking whether a single TWD can handle multiple Task Queues, or if each TWD should map to a single worker instance. This doc clarifies:

  • Task Queue is defined in application code, not the TWD spec
  • One TWD per Task Queue is recommended for independent scaling and rollouts
  • When multiple queues per TWD might be acceptable

Checklist

  • Follows existing docs structure and style
  • Includes practical YAML examples
  • Links to related concepts (TemporalConnection)

🤖 Generated with Claude Code

@bchav bchav requested review from a team and jlegrone as code owners January 28, 2026 17:21
Explains the relationship between TemporalWorkerDeployment and Task Queues.
Multiple task queues can be grouped in a single TWD by running multiple
containers (each polling one queue) in the same pod. Splitting into
separate TWDs is an optimization when queues have different scaling
requirements or deployment cadences.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@bchav bchav force-pushed the docs/twd-architecture-diagram branch from 183f4f2 to 1a88982 Compare January 29, 2026 17:23
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