bring incomplete docs into a shape that can be released

close documentation branch docs/3.1

(0) -1000 -300 -100 -30 -10 -2 +2 +10 +30 +100 tip

mercurial