Rewrite Task Queue Priority and Fairness page for GA (#4511)

* 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>

Author: 3 people