adding some corrections / comments to readme