doc(API): Improve middleware and req_options docs

Expand middleware documentation and add API.req_options docs to the
API reference.
Merge pull request #371 from kgriffs/chore

doc(API): Improve middleware and req_options docs