bump dependencies + improve doc