remove the unused method _will_expire_soon

This method is unused, the check logic will be done in auth plugin.

Change-Id: Iafcaf0efa0a6730826c04d1ef846ae333e16fee0
documentation for audit middleware

this moves (and edits) audit middleware documentation from pycadf
library to keystonemiddleware

pycadf doc: https://github.com/openstack/pycadf/blob/master/doc/source/middleware.rst

Implements: blueprint audit-middleware
Change-Id: I068f312d8927010fd209eab5c22910c4d1d343a1
Merge "remove the unused method _will_expire_soon"
Merge "documentation for audit middleware"