I was just going though the DnD code in the Book and came across a Dojo function I didn't know about and was about to look it up then thought that it would be really cool if a little summary (or even a big one) from the API documentation would appear if I kept my mouse over the function name in the code insert. Would be handy in the API doc as well and with Drupal not such a biggy to make happen really.
Just a thought ;)

That's a great idea
That's a great idea actually. I have code that scans text and replaces instances of words like dojo.addClass and creates a link to the API page for the function, it would be trivial to setup something more automated using the documentation RPC pottedmeat has put in place ...
Ya, it would be nice to suck
Ya, it would be nice to suck in the basic info like the function signature and perhaps the one line description of what the function does so you could check what the function did quickly while reading an example and not have to leave the page to check it out.
The text scanner sounds cool. Is it PHP or JS?