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](http://stackoverflow.com/documentation/java/99/arrays#t=201608050943095557733):

 - **600 (!) up-votes** for the "top" example about ["Creating and Initializing Arrays"](http://stackoverflow.com/documentation/java/99/arrays#t=201608022003212064415)
 - **100 up-votes** and at the "second place": ["Creating a List from an Array"](http://stackoverflow.com/documentation/java/99/arrays/495/creating-a-list-from-an-array#t=201608050937075742809)
 - and **40 up-votes** has got the third example which deals with ["Creating an Array from a Collection"](http://stackoverflow.com/documentation/java/99/arrays/433/creating-an-array-from-a-collection#t=201608050937075742809)

---

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.*

And even if some of us starts 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.

The question is now, **do we need to adapt our voting system for documentation examples?**