Post 1.2.0 docs update 1

@jamtur01 @fredlf @ostezer please consider :)

@crosbymichael and @vieux I've included one possible merge conflict here for you to veto 
- `Update flag usages and docs for max restart count … 	f3b64d5`

the rest are `docs` only.