Skip to content

Add Task Queue Priority and Fairness reference#98

Open
starfleeth wants to merge 1 commit intomainfrom
add-priority-fairness-reference
Open

Add Task Queue Priority and Fairness reference#98
starfleeth wants to merge 1 commit intomainfrom
add-priority-fairness-reference

Conversation

@starfleeth
Copy link
Copy Markdown
Contributor

@starfleeth starfleeth commented Apr 27, 2026

Summary

  • Add references/core/priority-fairness.md covering Priority (keys, inheritance, when to use) and Fairness (keys, weights, virtual queues, round-robin dispatch, rate limiting, weight overrides, enabling, limitations) with SDK examples for Go, Java, Python, TypeScript, and .NET.
  • Update SKILL.md to proactively surface Fairness when developers are building multi-tenant applications, before they hit tenant starvation problems.
  • All content grounded in the official Temporal docs (docs/develop/task-queue-priority-fairness.mdx), verified by a review pass that removed ungrounded claims (key size limits, weight ranges) and added missing caveats (dispatch-time semantics, transition behavior).

Test plan

  • Read through references/core/priority-fairness.md and confirm SDK examples are correct
  • Verify SKILL.md section triggers the right guidance in a conversation about multi-tenant apps
  • Confirm no existing references were broken

🤖 Generated with Claude Code

Add a core reference file covering Priority (keys 1-5, inheritance,
when to use) and Fairness (keys, weights, virtual queues, round-robin
dispatch, rate limiting, weight overrides, enabling, limitations) with
SDK examples for Go, Java, Python, TypeScript, and .NET. Content is
grounded in the official Temporal docs.

Update SKILL.md to proactively surface Fairness when developers are
building multi-tenant applications, before they run into tenant
starvation problems.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@starfleeth starfleeth requested a review from a team as a code owner April 27, 2026 23:32
@starfleeth starfleeth requested a review from jpvotta April 27, 2026 23:33

When you start using fairness keys, it switches your active Task Queues to fairness mode. Existing queued Tasks are processed before any new fairness-mode ones.

**Temporal Cloud**: automatically enabled when you start using fairness keys.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

We should say that, in Temporal Cloud, you need to enable Fairness within Namespace Settings in the UI. Simply setting Fairness keys will not work until Fairness is activated at the Namespace level.

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