Skip to content

Commit dc502f7

Browse files
committed
feat(task queues): updated limitations section
1 parent 43eb122 commit dc502f7

File tree

1 file changed

+11
-14
lines changed

1 file changed

+11
-14
lines changed

docs/develop/task-queue-priority-fairness.mdx

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -65,9 +65,7 @@ For example, all of your priority level `1` Tasks will execute before your prior
6565
lower priority Tasks will be blocked until the higher priority Tasks finish running. Tasks with the same priority level
6666
are scheduled to run in first-in-first-out (FIFO) order. If you need more flexibility to allocate resources to Tasks of
6767
the same type, like processing payments for multiple e-commerce platforms, check out
68-
[the fairness section](#task-queue-fairness).
69-
70-
When you update priority levels, the Task Queues will only reflect these changes for Tasks that haven't dispatched yet.
68+
[the Fairness section](#task-queue-fairness).
7169

7270
Choose your SDK below to see an example of setting priority for your Workflows:
7371

@@ -582,14 +580,13 @@ var handle = await Client.StartWorkflowAsync(
582580

583581
### Limitations of Fairness
584582

585-
When you use Worker Versioning and you're moving Workflows from one version to another, Priority will still apply
586-
between versions. Fairness isn't guaranteed between versions. For example, you may have Tasks that were originally
587-
queued on Worker version _alpha_, Tasks that were queued on Worker version _beta_, and some Tasks were moved from
588-
_alpha_ to _beta_. Fairness is only guaranteed when Tasks are originally queued on the same Worker version. So there
589-
might be some discrepancies on the Tasks moved from _alpha_ to _beta_.
590-
591-
There isn't a limit on the number of fairness keys you can use, but their accuracy can degrade as you add more.
592-
593-
Task Queues are internally [partitioned](/task-queue#task-ordering) and Tasks are distributed to partitions randomly.
594-
This could interfer with fairnesss. Depending on your use case, you can reach out to Temporal Support to get your Task
595-
Queues set to a single partition.
583+
- There isn't a limit on the number of fairness keys you can use, but their accuracy can degrade as you add more.
584+
- Task Queues are internally [partitioned](/task-queue#task-ordering) and Tasks are distributed to partitions randomly.
585+
This could interfer with fairnesss. Depending on your use case, you can reach out to Temporal Support to get your Task
586+
Queues set to a single partition.
587+
- When you use Worker Versioning and you're moving Workflows from one version to another, Priority will still apply
588+
between versions. Fairness isn't guaranteed between versions. For example, you may have Tasks that were originally
589+
queued on Worker version _alpha_, Tasks that were queued on Worker version _beta_, and some Tasks were moved from
590+
_alpha_ to _beta_. Fairness is only guaranteed when Tasks are originally queued on the same Worker version. So there
591+
might be some discrepancies on the Tasks moved from _alpha_ to _beta_.
592+
- Fairness stats are not persisted, so server deployments can cause temporary lack of Fairness and misordered tasks.

0 commit comments

Comments
 (0)