It would be realy nice if reordering examples while editing a documentation page would be enabled, this way - we could set the most important examples first.
It seems in this case that the existing (and appropriate) SO design for questions and answers is constraining the design of SO Documentation in an inappropriate way. I would expect SO Documentation to behave more as Wikipedia does, allowing community edits of a Document, possibly constrained by Reputation. The power of voting would be helpful in ranking the entire Document, but it's an awkward method of moving Examples around within a Document. As @dayne writes in How do I reorder examples on Documentation?,
We are not talking about solutions to discrete questions, but trying to provide a set of basic documentation that should be organized logically.
feature-request
whereas the other is simplydiscussion
. – Heretic Monkey Sep 19 '16 at 13:44