This is a great idea. I can't tell much from the image you provided about how the code samples are distinguished from the rest of the text. Usually you want code samples in a slightly different font - say a monospaced font - from the rest of your text. And then there's the problem of line wrapping in code samples - in an indentation-sensitive language like Python, that could be more of a problem but even in cases where it doesn't mislead the reader about the way the language works, it could be unsightly. Perhaps you haven't gotten that far yet or someone else will improve upon it and contribute the patches back to you. Great start, though. I was resolute about not getting an iPad but this is the first really good argument I've seen in its favor.
It seems like the Internet has killed the reference book format for a lot of programming subjects. Now okay, it's also killed the market, and that's not coming back, but the format can still be useful. Especially for the iPad, which in my opinion is a lot better suited for reference books than the traditional e-ink readers.
How about we just rewrite the format/style/design of ruby docs to be something more readable in the first place?<p>Or you know, actually document shit beyond "the source code".<p>(I'm totally grabbing this, fyi)
I think reference and other kinds of docs will be one way in which the iPad will work better than a netbook for a lot of the power user crowd. Having docs on the netbook isn't quite the same thing.