Document cache behaviour

fixes #17