added additional documentation regarding cache clearing