update variable names to be more clear, update README