minor documentation/code clarity changes