now working on 3.8.9
docs; make the code runnable

#1909
Merge branch '3.8.x' into gh-pages
website; regen