Added a note to document when deprecated things goes out
Keep deprecated things for min 2 major versions (ref #1982)
Change the call from $cache->check to $cache->read since check is deprecated
Added a note about the version when we will removed the deprecated members