some updates to the user guide