responses: tweaks/fixes to docs