readme improvement and example fix