updates for @veronicaerb's notes