readme fix and minor commenting changes