updated 'intro' and 'how it works' sections of doc, please feel free to review/amend