This whole paragraph is not easy enough to understand, and also some formatting would help. But instead of having it in a separate document, we think it should be documented directly in the code and become the introductory content of http://remotestorage.io/doc/code/files/caching-js.html