The doc should make it clear what cache invalidation is about

[stof]

This bundle confused some people reading the Symfony doc, where it explains that if you rely on the cache validation model, you never need to invalidate your cache: symfony/symfony-docs#4118

The bundle should explain the difference between the cache validation model and the cache invalidation model implemented in this bundle (for the most part of the bundle as annotation-based config can be used without doing invalidation)

[ddeboer]

For starters, we could link to http://foshttpcache.readthedocs.org/en/latest/invalidation-introduction.html#what-is-cache-invalidation, where we mention both benefits and possible downsides of cache invalidation.

[stof]

indeed, this looks like a good explanation