New GitHub issue #93934 from mhaas:<br>

<hr>

<pre>
**Documentation**

The `Executor.map` method is not guaranteed to return results in-order, as is shown in the [docstring for that method](https://github.com/python/cpython/blob/ffc228dd4e409336f2c2ad54125de384bf1a767b/Lib/concurrent/futures/_base.py#L584):

```
        Returns:
            An iterator equivalent to: map(func, *iterables) but the calls may
            be evaluated out-of-order.
```

The [documentation on `docs.python.org`](https://docs.python.org/3/library/concurrent.futures.html#module-concurrent.futures) does not mention this. There, the only difference to the built-in `map` as stated as follows:

```
Similar to [map(func, *iterables)](https://docs.python.org/3/library/functions.html#map) except:

* the iterables are collected immediately rather than lazily;

* func is executed asynchronously and several calls to func may be made concurrently.
```

It would be great if the HTML documentation on `docs.python`.org could also mention the results may not be in order.
</pre>

<hr>

<a href="https://github.com/python/cpython/issues/93934">View on GitHub</a>
<p>Labels: docs</p>
<p>Assignee: </p>