http/response: add some specs and docs