added readme
added footnotes
Merge branch 'master' into gh-pages