The documentation voting system reminds me somehow of "Hot Network Questions" and their answers:
You vote it up because others voted it.
The result can be seen for example in Javas Arrays topic:
- 630 (!) up-votes for the "top" example about "Creating and Initializing Arrays"
- 100 up-votes and at the "second place": "Creating a List from an Array"
- and 40 up-votes has got the third example which deals with "Creating an Array from a Collection"
The voting system meets the requirements perfectly for Q&A sits:
Good, interesting, well written and right answer are voted up and rise to the top. The best answers show up first so that they are always easy to find.
But the key is documentation examples are different:
Good, interesting, well written and right examples are only voted up and rise to the top because they are on top. This is because most of us tend to vote the top two examples (me too), even if others are equally helpful too.
Even if some of us start to up-vote other examples, they really have no chance to get under the top three. As @Frank pointed out, why bother editing other examples or adding new ones if no one is going to look at them: We – as an editor – gain much less voting for them. Instead if you really want to get reputation, you should try to edit one of the top examples …
On the other hand it’s the question why should we up vote an example? All examples are equal: the example I find interesting or useful could be uninteresting for you because you already know the described things. @samgak pointed out that the "sort by most popular" functionality should be removed from documentation since the only purpose this "stack overflow"-style serves for someone using the documentation is to find the best topics to edit for maximum reputation.
Another thing is as @ken2k mentioned in his comment, if you down-vote an unclear, incomplete, overly-broad example, from the day on it is vastly improved by someone else, it still has your down-vote. Although we can argue this problem applies to Q&A too, an example on the documentation is more likely and also supposed to be edited by many people to be eventfully drastically changed compared to ordinary answers or questions.
The question is now, do we need to adapt our voting system for documentation examples?