add commentary
some minor changes