extend docs

Closes #9

LGTM given by: @

Squashed commit of the following:

commit c7ef57a35b25d47630cda7aa919d369c4347dce5
Author: Samuel Esposito <s.esposito@roqua.nl>
Date:   Thu Oct 2 13:45:27 2014 +0200

    remove respondent

commit c978355cbf9d8b6d49f5ee13942adcca5836a39e
Author: Samuel Esposito <s.esposito@roqua.nl>
Date:   Thu Oct 2 10:56:33 2014 +0200

    extend response api docs

commit 35b4b4865ed8c42e8f0cb499e534f97b66ddf027
Author: Samuel Esposito <s.esposito@roqua.nl>
Date:   Thu Sep 25 17:10:59 2014 +0200

    extend docs