The keywords here are very messy and inconsistent. Examples:
:collection "a sequence" :coll "a sequence" :collection-map "a sequence"
:sequence "a sequence of vectors with only 2 elements or a map with key-value pairs"'
Some of these should definitely be revisited, not only here, but in our core function specs.