added some instructions to readme.md
updated some abstract method signatures, comments