significant improvements to the documentation