updates and content editing after @veronicaerb's feedback