Document the cache implementation

Also make a minor correction to the NullCache to make it consistent.