more readability updates