read me update and tests