thanks for your comments. 

do we intend to have this example as part of the docs? Note that the filename is not preceded by `plot_`. I don't know if sphinx can handle an example where two files have to be run simultaneously from different terminals.

I'll address the rest and notify! :)