further updates to the tutorial