update the doc with the latest changes