[enh] add links to read the docs
[enh] make links clickable
[fix] typo
[enh] add ugly shcemas