add some html docs for each kind of broker to help folks grok the difference