docblock all the things!
make cache implementations more compliant to the CacheInterface documented return types