doc: add warning for socket.connect reuse

Author: ronag

doc/api/net.md

@@ -600,6 +600,10 @@ the error passed to the [`'error'`][] listener.
 The last parameter `connectListener`, if supplied, will be added as a listener
 for the [`'connect'`][] event **once**.
 
+This function should not be used for reconnecting a socket. Calling
+[`socket.connect()`][] a second time leads to undefined behavior.
+[`net.connect()`][] implicitly calls [`socket.connect()`][].
+
 #### `socket.connect(options[, connectListener])`
 <!-- YAML
 added: v0.1.90