diff --git a/doc/source/iter.rst b/doc/source/iter.rst index d46d1a096..728969770 100644 --- a/doc/source/iter.rst +++ b/doc/source/iter.rst @@ -198,6 +198,11 @@ distributed training: work = [train.remote(shard) for shard in it.shards()] ray.get(work) +.. tip:: Using ParallelIterator built-in functions is typically most efficient. + For example, if you find yourself using list comprehensions like + ``[foo(x) for x in iter.gather_async()]``, consider using + ``iter.for_each(foo)`` instead! + API Reference -------------