This post was inspired by the "Is Documentation failing?" question, but it's something I've been thinking about for the system.
The fact is: The idea of world-editable, world-moderated content makes sense for a Q&A site. Q&A is mostly ephemeral, with most questions not having long lasting value. If some question is badly answered it's no big deal; it will be asked again and eventually a good answer will rise up. Asking a question you're not expecting an authoritative response, you're hoping for some help. Opening it up to the world makes sense, because someone can just happen to know the answer and throw in their two cents.
Documentation is different. Documentation should be highly accurate, highly consistent, and highly informative. Documentation should be written by experts in their field. You should count on documentation being correct, not maybe correct or just an idea, or a response thrown in by someone who doesn't really understand what you're asking, like you get in Q&A all the time.
This is why Documentation has problems. You're trying to treat it exactly like Q&A, and by its very nature, it isn't. And so you have the morass that is Documentation. But that's OK, because it can be fixed. One of the first rules of startups is to be willing to throw one away. Well, let's throw this one away and start again.
Here's how the new Documentation should work:
- Anyone can request a topic, and vote for its priority in the list of topics to write.
- Only silver badges and higher in the corresponding tag can write/edit documentation.
- Only gold badges and higher can approve documentation/edits. If gold badges differ, it goes by what side gets more gold badges to vote.
- No reputation. Instead, your username gets listed as a contributor to that page, if your change is accepted.
- Gold users can accept changes as either minor (not added to list of contributors; used for spelling mistakes and copy editing) or substantial (for anything that fixes bugs, adds code or explanations; added to list of contributors).
- On a user's main and jobs profile, you can see a list of pages they have contributed to.
You'll get much less documentation. But the documentation you will get, will be higher average quality, more accurate, and more usable. And if you're calling it documentation, that's exactly what you want.
Yes, it's elitist. But you don't want someone who just read a high school textbook to write books on physics, you don't want to let someone who hasn't demonstrated mastery to write this.
KeyPress
event for that, which you definitely should not.