Docs for contestpopulation

[rogiervandergeer]

Just looking at the docstrings it is not immediately clear what the evaluation function should look like.

[koaning]

This will be picked up by an example that is added to sphinx