updated doc with new socket connections