minor fixes to readme + changes explanations