more readme updates and formatting fixes