Fixes to the docs about cache limitations

@neumino -- could you please code review?