improvements to the documentation