more improvement to the documentation