[3/2] better docs

Probably nice to also mention how to make our cache code work with Varnish.