added doc blocks over the responses