improvements to docs