add documentation for populating cache