improved cache documentation