And when you split it in separate ipython blocks, you can put the comments just as normal text in between.