update readme and correct a list ordering bug