Add some documentation making it explicit that the input object can be modified by a map operation for composability reasons