Can yield (not return) a list of tasks.

[bmaggard]

Returning tasks from run(), even in a list, does not add dependencies. yield does.

Description

Clarifying the documentation to specify the proper mechanism by which to add dynamic dependencies.

Motivation and Context

The documentation is incorrect.

Have you tested this? If so, how?

I tested with the following cases. TestYieldTask performs as desired. TestRunTask does not.

class TestYieldTask(DoDynDepTestTask):

    def run(_s):
        yield [ DynDepBTestTask(), DynDepCTestTask(), ]
        super().run()

class TestRunTask(DoDynDepTestTask):

    def run(_s):
        super().run()
        return [ DynDepBTestTask(), DynDepCTestTask(), ]

[mention-bot]

By analyzing the blame information on this pull request, we identified @steenzout, @erikbern and @jcrobak to be potential reviewers

[Tarrasch]

Thanks. Usually for these small docs fixes, you can get away with a more lightly motivated PR (as the maintainers know already if you must yield or return). :)

While at it, I guess it should say "yield any iterable", not only "yield a list"