fix response spec
start working on the documentation layout