some better comments and variable names