FYI,

I just made some pretty big updates to our dispatcher documentation. This stuff is hard to view as a code review, so I just merged it (it can't be worse than what we had) and it can be viewed at:

http://lava-dispatcher.readthedocs.org/en/latest/

Please let me know if something looks bad (or even better make the change yourself)