updated explanatory text and code in readme