find_distributions documentation issues
The section "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. So if someone writes a
find_distributions which returns a list, this will fail.
.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?