add more documentation regarding the population->evolve method.