overall cleanup, markup and semantic modifications
new readme to explain differences between upstream repo