improved documentation for middleware by giving example cache entries [skip ci]