tweaks wording
describes the current workings
adds more notes