fix readme and minor syntax changes