documentation + fix a bug when collecting data in a city in a the default list