improvements to doc