this adds better support for documenting request and response headers.