documentation: improve readability; line length, indentation, highlighting.
related pull requests: #1036 #1038 #1043