Rework documentation, add chapter about responses

@XWB @asm89 ping :panda_face: