Examples: Try to achieve more coherent text and code blocks
I find the examples difficult to read because there is often a constant change of formatting between text and code.
Wouldn't it be easier to read if, for example, member functions are always one code block and the text above describes the whole function at once? I think it is easy to get which step does what part of the description. Probably even easier to get than now.