some improvements to the read me