fix socket, add join method, update documentation