* Add more details and formatting to changelog
* Add some more reference links to classes, methods, and functions mentioned in docs

* Use sphinx-apidoc to auto-generate sources for backend modules
    * Still manually adding other modules for more control over formatting
* Add a couple more contributors I missed
* Include contributors on readthedocs
* Add 'all' Makefile target and clean auto-generated docs
* Remove unused build targets in Makefile
* Update interpshinx links that have moved
* Fix some interpshinx links
* Fix some `:ref:` links using auto-generated labels (and some manually added labels where convenient)
* Fix some docstring formatting
* Fix remaining build warnings

* Closes #135, #165
* Add a 'Summary' section at the top of the Readme explaining the scope of requests-cache and why you would want to use it
* Add some more info explaining the difference between using `CachedSession` directly vs. patching with `install_cache()`
* Move basic examples from 'User Guide' section into Readme
* Include Readme in Sphinx docs (using `.. mdinclude::`) and remove duplicate sections
* Include Contributing guide in Sphinx docs
* Convert History doc to markdown and include in Sphinx docs
* Use `automod` options to move main cache documentation from `CacheMixin` back to to `CachedSession`, since that's probably where a user will look first
* Add more detailed usage examples to an 'Advanced Usage' section for `CachedSession` options (`filter_fn`, `ignore_parameters`, etc.)
* Update example scripts and move them to `examples/` folder

* Add individual expire_after per request.

This commit adds a new feature to allow individual expire_after times
per request.
It involves using a custom CachedSession, PerRequestCachedSession,
to be used as the session_factory.

* Replace deprecated asserts in unit tests

Additionally, some sockets are closed even on test failures.
This removes some visual clutter when going through the results.

* Update docs and README for per-request caching

* Remove per_request and integrate behavior into CachedSession

* Make test_return_old_data_on_error more reliable

This is achieved by using a fixed date and mocking the backend calls to datetime as well.

* Adjust per_request cache to new behavior

Also adds HTTPBIN_URL environment variable as in test_cache

* Add tests for the function determining the expiration datetime

* Adjust backend to store expiration dates

This also involves slightly different semantics for deletion, but the behavior stays the same.

* Minor: black and isort

* Update docs for request

Add explanation for expire_after special cases, i.e. 'default' and 'cached' and how precedences are handled

* Replace assert statements with methods

* Remove invalid snippet from README

* Remove invalid sentence from docs.

* Make expires_before timezone-aware once

And combine the checks for expiration

* Simplify complexity by removing 'cached' keyword for expire_after