improvements to documentation