renamed README->README.md
comments in methods