incorporate the feedback for the new README