beaucoup more docs fixes