Minorupdates

improved readme, new comments and some minor fixes. No need to review