Improve documentation for running examples

Would it be possible to add some documentation for running a simple example together with a description of the expected output or windows etc. shown?

Background to request: I'm trying to set up the simulator to run on macOS and am not sure if I've set up everything right or am just running the examples wrong.