Docs merge 1.0.1 post1

an initial set of docs fixes that would be good to have before we hit 1.1.0 changes