The section ["Extending the search algorithm"](https://importlib-metadata.readthedocs.io/en/latest/using.html#extending-the-search-algorithm) says that `find_distributions` must return an iterable. However, the current implementation actually requires an iteratOR, because it calls `next` [here]( https://gitlab.com/python-devs/importlib_metadata/-/blob/996696b59db72778af30c8797c7e1b51211faf57/importlib_metadata/__init__.py#L201). So if someone writes a `find_distributions` which returns a list, this will fail. Separately, the `DistributionFinder.Context` `.name` attribute is documented as indicating "names to match" (plural). However, it's actually just a single string. Finally, it says that `DistributionFinder.Context` "may supply other relevant context". This is so vague as to be useless. If it's supposed to mean "we may add other properties in the future", isn't that true of any API?