On 16 Jun 2017, at 12:48, Gunnar Morling <gunnar@hibernate.org> wrote:

Back to the core subject, I can’t quite remember why I added Map to the list of isIterable() elements.
I suppose that if we follow that path, any container that returns multiple elements should return isIterable == true (i.e. containers that call iterableValue, indexedValue or keyedValue.
So I’d add arrays and any multi-valued container to the definition of isIterable()

Ok, cool. I'll add arrays then.

For other containers, I'd add this when adding more built-in
containers to the spec in the future.

My point is that isIterable goes beyond the built-in containers. It’s is true of custom containers (e.g. Guava’s etc). If we don’t change the JavaDoc, this is misleading.