ws: improve doc