modifiying some parts of the documentation to improve it