tl;dr
Documentation would fill a better niche and be generally more useful if we focused less on specific languages, and more on specific libraries. The largest examples of documentation that we have are centered around languages, of which there is already an abundance of elsewhere.
We as knowledgeable software experts should focus our efforts in Documentation to libraries used in these languages, and not the languages directly, to be decided by the people primarily involved in these languages.
Given that we're tearing down how Documentation works now, this would be a golden opportunity to address this issue.
I'm a bit over Documentation right now. To put it a gentler way, the way I want to contribute to it right now (doing more janitorial tasks and keeping silly requests at bay) isn't all that recognized. Worse, what I want to use it for isn't possible.
When it launched, I was enthused at what it could bring and what promise it held; it could bridge the gap between terrible documentation and very knowledgeable domain experts to really make something awesome.
However...
I'm starting to grow weary of seeing topics that cover really basic stuff. Like, easily Googleable stuff. We're getting a lot of noise here in stuff that's easy to search for, and not a lot of signal in the more complicated things. Why do I need the (n+1)th article on how to manipulate arrays?
We're not getting experts talking about the libraries that we deal with [on a constant basis] filling in the gaps behind different approaches of Spring Bean configuration; we're getting folks adding another coat of paint to the bike shed, and I admit I'm very guilty of this too.
I've been thinking on this since the whole brouhaha behind the reputation issue came about, and the primary thing that struck out to me was that it was the more popular and venerable languages that existed were the ones that gained more attention and more documentation.
I'm not convinced that this is a good thing anymore. Most every top language in Documentation has really decent documentation around it (I'm looking square at Java; those who haven't heard of the Java Trails haven't looked very well), and it feels like we're just regurgitating that information here.
So, my proposal is to remove language documentation from Documentation, should the community permit it to happen.
I'm not going to deny that smaller, lesser known languages like D could benefit from a system like this, but the larger and more influential languages like Java and C# don't really thrive in this system. They've already got a lot of documentation around them and adding the same information in another place on the Internet seems counter-intuitive.
How this would work:
- Gold badge holders in a programming language (let's start right now with C, C++, C#, Java, JavaScript, Ruby, and Python) would be allowed to cast a vote on whether or not the documentation for their language is eligible for deletion.
- If there are 10 votes in favor of deletion, the topics and the tag are hidden.
- If the community decides to bring back the tag, Gold and Silver badge holders in that tag would be eligible to vote to bring it back.
- If there are 30 votes in favor of restoration, it would be reinstated.
- To mitigate flip-flopping, this sort of vote could only transpire once every so often; for instance, every six to nine months.