Some readme fix proposals

Also adding some comments on the lines.