more docs tweaks to get rid of warnings etc