Skip to content

Document Fairness enabling or disabling with active backlogs#4504

Closed
jpvotta wants to merge 3 commits intomainfrom
docs/fairness-active-backlog
Closed

Document Fairness enabling or disabling with active backlogs#4504
jpvotta wants to merge 3 commits intomainfrom
docs/fairness-active-backlog

Conversation

@jpvotta
Copy link
Copy Markdown
Contributor

@jpvotta jpvotta commented Apr 29, 2026

Adds a subsection covering what happens to active backlogs when Fairness is enabled or disabled at the Namespace level.

┆Attachments: EDU-6286 Document Fairness enable/disable transitions with active backlogs

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jpvotta jpvotta requested a review from a team as a code owner April 29, 2026 21:58
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 29, 2026

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Apr 29, 2026 10:08pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 29, 2026

📖 Docs PR preview links

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jpvotta jpvotta changed the title Document Fairness enable/disable transitions with active backlogs Document Fairness enabling or disabling with active backlogs Apr 29, 2026
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
jpvotta added a commit that referenced this pull request Apr 30, 2026
Merges content from PR #4501 (inheritance precedence chains for
Priority fields including fairness_key and fairness_weight) and PR
#4504 (Enabling or disabling Fairness with an active backlog) into
this PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jpvotta
Copy link
Copy Markdown
Contributor Author

jpvotta commented Apr 30, 2026

Folded into #4511, which is the consolidated rewrite of the Task Queue Priority and Fairness page. Closing this PR.

@jpvotta jpvotta closed this Apr 30, 2026
flippedcoder added a commit that referenced this pull request Apr 30, 2026
* Tighten Priority intro and enable instructions

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Refine Priority intro wording and inheritance sentence

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Merge priority key range into the use instruction

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reword Priority ordering paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Merge use instruction into priority key paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reword CLI example lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reword SDK Workflow example lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reword SDK Activity example lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reword SDK Child Workflow example lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Italicize priority key term

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Capitalize Workflow in SDK example lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Pluralize fairness weights

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove redundant sentence about fairness keys describing Task structure

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Trim redundant Task Queue scope from virtual queue sentence

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Trim hogging-capacity sentence

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Fold backlog-size clause into hogging-capacity sentence

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove redundant Worker-availability paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Lead with default equal-weighting, frame fairness weight as customization

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move one-weight-per-key warning to How to use Fairness as info panel

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Merge fairness weight intro and customization paragraphs

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Regroup virtual queue paragraphs in Fairness intro

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove redundant weighted-capacities paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove auto-enable info block

Goes stale post-rollout since fairness keys no longer auto-flip Task
Queues into fairness mode.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Link data structure to count-min sketch

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove redundant fairness-not-needed clause

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Tighten in-flight visibility caveat

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Combine tenant example paragraphs

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove batch jobs scenario paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move two-ways sentence under How Fairness works

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move dispatch-time caveat to Limitations of Fairness

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move How to use Fairness above How Fairness works

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reorder Cloud and self-hosted enable instructions, add dev server example

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Link dynamic config to the canonical configuration doc

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Document Cloud Fairness toggle in Namespace UI

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Correct Priority enablement to reflect v1.31.0 defaults

Priority is enabled by default in self-hosted as of v1.31.0
(matching.useNewMatcher defaults to true). The flag is for
disabling, not enabling. Drop the dev-server example since
there's nothing to turn on.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Drop enableMigration instruction (default is true in v1.31.0)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Link dynamic config to canonical doc in self-hosted Fairness paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Add dev server example for enabling Fairness

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove stale Cloud toggle and pricing-rollout notes

Cloud namespace toggle has shipped and is documented above. Pricing
rollout details belong in the cloud pricing doc, not here.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Note Fairness is paid in Cloud and link to pricing

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Add lead-in stating users must set fairness keys to use Fairness

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove dev server example for Fairness

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Mirror Priority lead-in style for Fairness CLI and SDK examples

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Tighten weighted distribution example

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move one-weight-per-key warning below Child Workflow SDK block

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Expand To use Fairness lead-in with weights example

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Add same-key FIFO sentence to To use Fairness lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move fairness-details image below How to use Fairness lead-in

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Move unkeyed Tasks paragraph below last Fairness SDK block, merge into one paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove redundant update-takes-effect-on-undispatched note

Already covered in Limitations of Fairness at the bottom of the page.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Remove How Fairness works section

Content already covered in How to use Fairness lead-in.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reorder heading to Priority and Fairness

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Reword Priority and Fairness combined paragraph

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Tighten enable instructions

Drop redundant "available for both" line in Priority section. In
self-hosted Fairness instructions, drop "pre-release" (GA in v1.31.0)
and matching.useNewMatcher (defaults to true; enableFairness implies it).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Fold in Inheritance and active-backlog subsections

Merges content from PR #4501 (inheritance precedence chains for
Priority fields including fairness_key and fairness_weight) and PR
#4504 (Enabling or disabling Fairness with an active backlog) into
this PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>
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.

1 participant