Skip to main content
4 of 18
added 1088 characters in body
Nick Volynkin
  • 15k
  • 1
  • 17
  • 27

What's the problem with excerpts

Let's not discuss a single tag wiki, but focus on the common practice of writing and accepting tag wikis and excerpts that are:

  1. A copyvio, usually from Wikipedia
  2. Totally awful, according to the guidelines for writing excerpts. Later in this answer there's a detailed explanation to why they are bad.

Many tag wikis are blindly copy-pasted texts, and many excerpts give no clue about usage. The problem is quite large. It needs a joint community effort to improve the situation.

#Replying to the comments.

Why don't you make an edit yourself?

To all those saying "go make an edit" — But indeed, I've just suggested an edit that shows the change that appeal to. I've used the excerpt as a guideline.

Is this question offensive?

About the "you're passive-agressive" implication, which appeared in some of the now-deleted comments:

I fail to see any offence in this post. What I see is confusion and disappointment, with a little bit of indignation. There certainly is an excuse for it. Dozens of reviewers approved a description which is 1)plagiarism 2) just a bad wiki excerpt. I'm disappointed too.

Yes, autor points at a mistake that the community has made at lots of edits and reviews. It's never pleasant when somebody points at your mistake. But is not an offence, and even not blaming. It's a call to responsibility.

Please stop saying "how could we know, don't blame us". Nobody blames anybody. But since you know it now, please make an effort to improve the situation.

#Why copied text is always a bad tag wiki excerpt

I'd like to emphasize that any text, copy-pasted from Wikipedia's definition of any subject is never good for tag wiki excerpts.

Citing from Jeff Atwood's post on SE blog (emphasis mine):

Here's a few words of advice on writing tag wiki excerpts:

  1. The excerpt is the elevator pitch for the tag. You only have ~500 plain text characters for the excerpt, so don't feel obligated to cover everything in it! Save that for the 30,000+ character Markdown tag wiki. The excerpt should define the shared quality of questions containing this tag -- boiled down to a few short sentences.
  1. Avoid generically defining the concept behind a tag, unless it is highly specialized. The "email" tag, for example, does not need to explain what email is. I think we can safely assume most internet users know what email is; there's no value in a boilerplate explanation of email to anyone.

With C# being a very popular programming language, its short description is definitely a common knowledge among StackOverflow audience.

  1. Concentrate on what a tag means to your community. For "email" on Server Fault, mention the server aspects of email including POP3, SMTP, IMAP, and server software. For "email" on Super User, mention desktop email clients and explicitly exclude webmail, as that would be more appropriate for webapps.stackexchange.com.

So, what does it mean? Any word about on- and off-topic questions about C#?

  1. Provide basic guidance on when to use the tag. In other words, what kinds of questions should have this tag? Tags only exist as ways of organizing questions, so if we don't provide proper guidance on which questions need this tag, they won't get tagged at all, rendering the tag excerpt moot. Think of it as a sales pitch: in a room full of tags screaming "pick me!", what would convince a question asker to select your tag?

What tags should I use with it, if I'm asking about C# debugging, or C# bytecode, or some library in C#? The excerpt doesn't say. Okay, I'll go read the whole tag wiki. What, not a single word about it?

  1. Some tags are common knowledge. Most tags require a bit of explanation in the excerpt, even if it's only 3 or 4 words. But if the tag is common knowledge -- that is, if you walked up to any random person on the street and said the tag word to them, and they would know what you were talking about -- then don't bother explaining the tag at all. Stick to usage of the tag within your community in the excerpt.
Nick Volynkin
  • 15k
  • 1
  • 17
  • 27