Skip to main content
2 of 3
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/

I agree with you, the C# Language tag looks horrendous. One of my notes for launch readiness was that we should discard the "C# 6.0 Features" topic as a big red pimple at the end of Documentation's nose. It's only gotten worse as more and more people add their two cents to the already-bloated examples. Tons of edits exist not to make the topic better for a reader, but to add another coat of paint to the bikeshed. It's the What's your favorite “programmer” cartoon? problem all over again.

And we really aren't too worried about it.

Joel wrote in The Wikipedia of Long Tail Programming Questions:

Stack Overflow is not just a historical record of questions and answers. It's a lot more than that: it's actually a community-edited wiki of narrow, "long-tail" questions -- questions that aren't quite important enough to deserve a page on Wikipedia, but which come up over and over again.

When you see a question that seems like it might reflect a common problem, don't just answer it to get a few points. That doesn't make the Internet any better. Instead, help us build up a library of canonical questions and answers that are more generic versions of the same question, and then start closing all the exact duplicates.

The Documentation expansion is the same idea, but for examples.

"Ok", I can already hear you ask, "If Documentation is basically like Q&A, why not make it easier to share examples within answers instead?" For as long as the site has been around, we have encouraged self-answered questions. Unfortunately, they have never really caught on as a method of sharing knowledge; other users tend to treat it as a form of cheating. The other problem is that self-answered questions come off a little like watching a debate in the House of Commons where both sides address the Speaker instead of each other.

At any rate, we are working on some methods to discourage mega topics and examples. Instead, Documentation should be more digestible. Take look at the bash topic Brace expansion and imagine that you've arrived here via a Google search:

Brace expansion

That's how Documentation ought to look for most readers. We have some ideas about how to make the browsing experience better. (Mine is to use citations as a metric.) But it won't matter until we get overly wordy examples and excessively long topics under control.

Jon Ericson Staff
  • 21.5k
  • 27
  • 153
  • 182