update markdown to read better