In PR #684, @Corvince had some concerns that are all valid. Please update the docs to address those concerns. Please submit as separate PRs to follow best practices.

• Concern 1: change to pipenv install mesa
• Concern 2: The literature references (line 35 and line 162 are still broken)
• Concern 3: Update figure

More details can be found here: https://github.com/projectmes

In prey_predator tutorial, there is a discrepancy sometimes between the variable names for:

• tutorial documentation : energy_transfer, max_transfer
• and gaml : energy_transfert, max_transfert
  See:
  https://github.com/gama-platform/gama/wiki/PredatorPrey_step3
  https://github.com/gama-platform/gama/blob/04000ca513629beb51a32e750a47b6bfad2cff3a/msi.gama.models/models/Tutorials/Predator%20Prey/

The user facing side of the code talks about sources wherever the source random processes feeding information into are target are meant.

Inside some classes, the word "sources" is used to specify a single random variable, i.e. the combination of the index of a random process and a time lag.

This can be pretty confusing for newcomers trying to contribute.

The spatial domain considered in MHYDAS_Roujan example includes RS, SU and GU layers.
The GU have a "iniwatertable" attribute which is not used by any simulators of the model.
Should we keep these unused data ?