# What's the problem with wikis and 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. Plagiarism, usually from Wikipedia 2. Totally awful, [according to the guidelines for writing excerpts][1] (This will be the subject of a different question) Many tag wikis are blindly copy-pasted texts, and many excerpts give no clue about usage. Both problems are quite large. **They need a joint community effort to improve the situation.** ### What should be done to improve wikis 1. Make sure that it explains well how and where to use the tag. 2. Add an instruction on how to ask a good question with this tag (or give a link to it) 3. If there's copy-pasted text either in the excerpt or the full wiki, add a note about it. > like this <sup>1</sup> > <sup>1: Source: (link)</sup> ### What should be done to improve wiki excerpts 1. Provide basic guidance on when to use the tag. 2. Add disambiguaton note, where necessary. 3. Add a note on complementary tags. 2. Reduce descriptions for popular and common-knowledge tags. Nobody reads the excerpt to learn about the subject. There's the full wiki, books, and the whole internet for that. [I've just suggested an edit that shows the change that I appeal to][2]. I've used the [tag:sql] excerpt as a guideline. Update: here's a good example of tag wiki excerpts: http://meta.stackoverflow.com/q/261378/2790048 --- # Further text doesn't answer the question. It addresses two other problems, one is connected to wikis and other is a general issue. I'm going to make separate posts out of it. But until then it stays here and you're welcome to read and discuss. ### The "hereditary disease" problem. The StackOverflow (in English) is the origin of a growing family of localized SO sites. Users on those sites look up to the SO standards and try to follow them. A problem emerged when a new user proposed an edit to a tag wiki excerpt on StackOverflow in Russian. That edit was just two sentences, copied from Wikipedia. The edit was rejected and the editor explained that **since this is the default style for wikis on SO, then it should be acceptable on RU.SO.** So, it's a double responsibility. StackOverflow is an example to all of the localized SO sites, and maybe to many other sites on the network. **Let's make it a good example.** ###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][3] (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. > 2. **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 common knowledge among StackOverflow's audience. > 3. **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 C# mean to the community? Any word about on- and off-topic questions about C#? > 4. **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 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? > 5. 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**. ### Replying to the comments — 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 and 2) just a bad wiki excerpt. I'm disappointed too. Yes, the OP points at a mistake that the community has made in lots of edits and reviews. **It's never pleasant when somebody points at your mistake. But it's 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 is blaming anybody. But since you know now, please make an effort to improve the situation. [1]: https://blog.stackexchange.com/2011/03/redesigned-tags-page/ [2]: http://stackoverflow.com/review/suggested-edits/9150460 [3]:https://blog.stackexchange.com/2011/03/redesigned-tags-page/