docs: detail the usage of S3 cache policy (#427) (#617)

* Add remarks to explain traps in the code

* Format code

* leave the comment, no code changes

Co-authored-by: Matthias Kay <[email protected]>

Author: npalm