more improvements to doc