document cache behaviour

fixes #17
Merge pull request #32 from antonagestam/document-caching

Document cache behaviour

Thank you for the help @erikcw :cake: