better comments in the update script