README and smarter cache method