Documentation tweaks

Move type annotation to a slightly more idiomatic position,  and highlight
connectPostgreSQL which in my opinion should generally be preferred to connect.