improve some issues with documentation