Document public API
Add connect & connect_uri examples

Add examples showing how to connect to the broker. And how to parse a
URI and connect to the broker indicated.