Better documentation

[CrazyPython]

A simple and fluff-free example with an explanation is all that's needed.

[jeremyBanks]

I'm going to work on a one-document overview of the public interface that should be easier to digest.

I'm also now generating Epydocs from master. They aren't great (we might want to consider finding a more modern tool), but might be useful to reference API details in some cases.

[Filnor]

Maybe provide a quick-start guide? That would have helped me a lot when I started out crafting bots with this lib.