added more notes, mainly to the intro section