some updates to the doc