added a docstring to explain the collection data structure and where/why
responses are created