readme improvements based on my lessons learned today