some doc improvs