additions and corrections to the tutorial