Update README

[AlexandreHutton]

The README.md is out of date and should be expanded to include requirements/effects, the self.function, docstrings, and mention the PlottingNode.

[AlexandreHutton]

Also add description of run(), _terminate(), and how the requirements are intended to work with the validator.