new text output during simulation, README annotations added