changes to readme and a few formating issues with lists
applied GH pages fix for codepen embed to master