Update parallel docs for new parallel architecture

[takluyver]

parallel_demos and parallel_winhpc have notes at the top stating that they still refer to the IPython.kernel code which was removed before 0.11. These should be updated for the new parallel processing architecture.

[fperez]

We've made some progress with this one. I grepped through the docs, and the only actual mention of IPyhton.kernel (other than for transition purposes) is here:

https://github.com/ipython/ipython/blob/master/docs/source/parallel/parallel_demos.txt#L7

There's also a note about the winhpc example not being updated to zmq:

https://github.com/ipython/ipython/blob/master/docs/source/parallel/parallel_winhpc.txt#L7

So now this should be an easy fix, it's almost there.

[minrk]

Yes, the API expressed in the files was updated prior to 0.11, but the performance numbers and some figures were not regenerated.

[minrk]

I reran the examples (not on WinHPC), and updated the docs accordingly. I did find some typos / issues from when the mcpricer example was turned into a notebook, and fixed those as well.

Something to note (/cc @ellisonbg): a notebook that relies on the implicit figure-closing behavior of the inline backend will not export as a functional script, because all plots will be to the same figure. It will also suffer from this problem if the inline backend is not used, or even if the inline backend is used with InlineBackend.close_figures=False. Relying on this behavior for anything other than a demo of the notebook is probably not a good idea.

[fperez]

Thanks for the fixes! And good point on the figure closing, indeed that behavior really is very 'notebooky', anyone making a script or thinking of one should be usig explicit figure() calls.