improve connect documentation