Add docs for the fairer task queue - #3256
Draft
droyad wants to merge 1 commit into
Draft
Conversation
Documents the fair priority task ordering shipped in Octopus 2026.2: when multiple projects have queued priority tasks, the task cap is shared equally between them so one project can't monopolize the queue. Adds a new page under Tasks and cross-links it from Prioritize Tasks. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
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.
What changed
fair-priority-task-ordererfeature toggle).prioritize-tasks.md, since this feature changes the ordering rules that section describes.Why
The fairer task queue is about to roll out to all customers, and nothing in the docs explains it. When multiple projects have queued priority tasks, Octopus now divides the task cap equally between them —
ceiling(cap ÷ projects)— and runs priority tasks from under-quota projects ahead of projects already at their share, so one project's bulk multi-tenant rollout can't monopolize the queue for hours.Content is based on the implementation and XML docs in
Octopus.Server/Orchestration/TaskQueue/FairPriorityTaskOrderer.cs; the worked example mirrors the RFC scenario pinned by the unit tests, and the self-hosted environment variable name was verified against the toggle provider code.Notes for reviewers
OCTOPUS__FeatureToggles__FairPriorityTaskOrdererFeatureToggle). If the plan is default-on in a specific release, that callout and the Availability section should be reworded. The toggle is slated for removal by end of Q4 2026, at which point the Availability section can go.🤖 Generated with Claude Code