doc(API): Improve middleware and req_options docs

Expand middleware documentation and add API.req_options docs to the
API reference.