add documentation and support for array responses

Hello, here's a pull request for creating response classes with an array type.
We didn't do any tests as we were unsure as to which strategy you were using.