[enh] add links to read the docs
[enh] make links clickable
[fix] typo
[enh] add ugly shcemas
Merge branch 'master' into gh-pages
[enh] update slides