readme improvements

readme improvements

readme formatting

better formatting

typo error in readme
resolving conflicts
improving venue spec