More docs, fewer lies
Clearer wording
Merge pull request #28 from m3dev/feature/improve-caching-docs

Fix and extend caching documentation