divided readme into parts a and b