Docs post 1.1.2 merge

This is essentially  what I want to update the 1.1 docs to contain.

it will need a rebase after the hotfix is built.