documentation: improve readability; line length, indentation, highlighting.
related pull requests: #1036 #1038 #1043
Merge pull request #1044 from crate/l/improve-docu-readability

documentation: improve readability; line length, indentation, highlighti...