document S3 cache more fully

Fixes #12289. Per earlier request of @mdo.
/to @twbs/team for review.