updated read me, clarity?