document cache behaviour

fixes #17