There is too much stress on examples via documentation. Examples are put at the top as the first section when you click on a topic. To me when I ask someone to read documentation, I am asking them to understand something. To read the definition and have an understanding of how something works. Then and only then should they be presented with examples.
But documentation on SO seems to be quite the opposite - it seems to stress out that examples are far more important than the definition or how to of a language or a language feature. To me this seems to introduce problems because now we are giving answers (the example) before someone can even understand something.
Here's an example: https://stackoverflow.com/documentation/sql/280/example-databases/1014/auto-shop-database#t=20160725163945149134 there are plenty more where I think the background information - known as remarks (in which I hate to use that word but it is what it is), should be the first section / topic when clicking on documentation.
My proposal is to move the examples to the END, not the beginning. Closely related to what this user was asking: Documentation should have an initial section