improvements to read me following first integration