Fair point on the local lookup bit, however I'm not sure where this would go right now. At the moment we don't have any specific docs on the cache other than what is generated automatically. The idea is that this cache should just work and people shouldn't generally need to mess with it or even know about it.