Post 1.2.0 docs update 6

plus is needs #8197 - so don't merge yet.

@jamtur01 @fredlf @ostezer