read, test links
more docs
merge master, generate docs
Merge branch 'doc/review/improve'