improved instruction messages and updated README