docs fixes and tweaks