Skip to content

Commit 29a26cc

Browse files
committed
fixup! Add user-facing docs for the new Task Loops feature.
The existing clear dialog labels this option Downstream, and whether it starts selected comes from the user's saved clear options, not from a fixed default. The page called it Clear downstream and said it is selected by default, so a reader who had changed that setting would not find the behaviour described.
1 parent 1f37397 commit 29a26cc

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

  • airflow-core/docs/authoring-and-scheduling

‎airflow-core/docs/authoring-and-scheduling/loops.rst‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -295,11 +295,12 @@ Clear tasks inside a loop
295295

296296
Use these controls to select how far a clear extends through the loop:
297297

298-
* **Clear downstream**, selected by default, includes downstream tasks.
299-
Clearing a task this way can also clear the gate in the same iteration.
298+
* **Downstream** includes downstream tasks. It starts selected unless you have
299+
changed your saved clear options. Clearing a task this way can also clear
300+
the gate in the same iteration.
300301
* **Clear later loop iterations**, selected by default, clears later
301302
iterations when the selection includes a gate task, whether selected
302-
directly or through **Clear downstream**. The gate runs again and decides
303+
directly or through **Downstream**. The gate runs again and decides
303304
whether the loop should continue from that point.
304305

305306
Clearing later iterations does not require the loop to run the same number of
@@ -316,7 +317,7 @@ Suppose each iteration contains this sequence:
316317
prepare → process → consume → gate
317318
318319
The loop has already run iterations 0 through 4. You clear ``process`` in
319-
iteration 2 with both default options selected:
320+
iteration 2 with **Downstream** and **Clear later loop iterations** both selected:
320321

321322
* ``prepare`` in iteration 2 remains completed.
322323
* ``process``, ``consume``, and the gate in iteration 2 run again.

0 commit comments

Comments
 (0)