example in readme, minor formatting and grammar fixes