improve doc

some random improvements and additions i stumbled over while updating our project.
this is still part of cache_control