documented new connection methods