If there's one complaint to make about IPython, it's that the authors seem to be positioning IPython as a scientific/mathematical tool, even though it is so much more. Most of its docs assume you will be using IPython for its pylab and matplotlib features, instead of as a general-purpose Python shell. This is not surprising considering its roots, but still.

That said, I thought it was quite straightforward to setup and use the IPython Notebook.