29

I'm not the best at this, so I thought it would be best to post a discussion rather than directly editing the excerpt.

Current excerpt:

C# (pronounced "see sharp") is a high level, object-oriented programming language that is designed for building a variety of applications that run on the .NET Framework (or .NET Core). C# is simple, powerful, type-safe, and object-oriented.

Problems I see:

  1. For some reason, object-oriented is repeated.
  2. Saying it's only object-oriented is very misleading, since it has a lot of functional features (the entire LINQ library couldn't exist without them, and that's only an example). It's much more a multi-paradigm language than an object-oriented one.
  3. It's misleading saying it "runs on .NET and .NET Core". What about Mono and, currently in preview..., WebAssembly? I don't see the point of including this part at all.
  4. It also supports the DLR, so it's as type-safe as you want it to be (I'm looking at you, Office interop)

For a starting point, I'd suggest something like the following.

C# (pronounced "see sharp") is a high-level, multi-paradigm programming language that is designed for building a variety of applications.

I don't think we need to say much more. We could add that a version-specific tag should only be used if the question is related to a feature introduced in that version.


We could go with something similar to what Revision 36 and Revision 45 had:

C# (pronounced "see sharp") is a multi-paradigm, managed programming language developed by Microsoft. Questions should include code examples, sufficient to reproduce the problem. Add extra tags, relevant to the used technology or library.

23
  • 7
    I agrree with the problems you pointed out. However your suggestion seems to general to me, since it could be used for every high-level, multi-paradigm language. Although C# is not restricted to them, .NET, type-safety (and object-oriented focus) are very important aspects of the language. Maybe these parts could be weakened. I wouldn't completely remove them.
    – Emaro
    Commented Sep 27, 2018 at 8:23
  • 16
    excerpt should be guidance when to use the tag, yes it needs updating, but you need to tell me when to use the tag and when not to use it, not just some general stuff about C# Commented Sep 27, 2018 at 8:27
  • 7
    It has been edited 59 times already. Meta is rarely a great place to find consensus about something so subjective even among the experts in a tag. If you truly want to reset this back from scratch then it doesn't need anything more than "C# is a programming language". The rest is pretty noisy elevator pitch, but somebody is going to add it back in less than a week :) Consider to just get rid of the repetition. Commented Sep 27, 2018 at 8:52
  • @PetterFriberg Yeah, but the current excerpt doesn't even help with saying when it should be used. How about something like my edit? Commented Sep 27, 2018 at 11:36
  • 1
    @Camilo I'm not an expert, but to me the include code stuff is wrong (let's hope Mark Amery) does not see that :), I have no experience in questions in that tag but a guidance would be something related to common problems in tagging, like "Always add this tag if your code is in C#, if the question is directly related to a specific version add version tag, please do only add tag of IDE if you have an IDE problem" Commented Sep 27, 2018 at 12:01
  • 1
    but I'm just guessing what the common tagging errors are Commented Sep 27, 2018 at 12:02
  • I will give you an example in a tag where I know what the problem is 1. They don't add main tag (If not no-one will probably see it) 2. They often add the tag even if not really related stackoverflow.com/review/suggested-edits/20975042, my english is not the best but a diligent Asker could get some guidance from that how to tag the question. Commented Sep 27, 2018 at 12:16
  • We run the risk we offend Jon Skeet if we get this wrong.
    – rene
    Commented Sep 27, 2018 at 13:51
  • maybe just rollback to revision 47 and be done with it. Commented Sep 27, 2018 at 14:41
  • 2
    Wikipedias definition is much more accurate: C# (pronounced C sharp) is a general-purpose, multi-paradigm programming language encompassing strong typing, imperative, declarative, functional, generic, object-oriented (class-based), and component-oriented programming disciplines.
    – Avestura
    Commented Sep 27, 2018 at 16:07
  • @0xaryan There was already problem for plagiarizing Wikipedia, so let's not repeat history: meta.stackoverflow.com/questions/302436/… Commented Sep 27, 2018 at 17:04
  • It is definitely not multi-paradigm. Having lambdas and closures thrown in does not make it a functional language. Static functions are still second class citizens, for example.
    – jpmc26
    Commented Sep 27, 2018 at 18:18
  • 1
    @CamiloTerevinto Also, only 2 of those are even language paradigms.
    – jpmc26
    Commented Sep 27, 2018 at 18:29
  • 1
    So if we want to improve the tag wiki, maybe we should tone down the marketing and focus on communicating some useful info?
    – jpmc26
    Commented Sep 27, 2018 at 18:31
  • 3
    The average programmer doesn't necessarily understand the meaning of "multi-paradigm language", while object-orientation is an established term. Strictly speaking, there is no such thing as an "object-oriented programming language", since object-orientation is a way to design programs. You can for example make C programs that are object-oriented, and you can make C# programs that are not. There are however languages with support for object-oriented features.
    – Lundin
    Commented Sep 28, 2018 at 10:00

2 Answers 2

15

Problems with the current excerpt at time of writing:

  • Reads like marketing material.
  • Includes a lot of meaningless fluff ("building a variety of applications", "simple," "powerful")
  • Does not explain when to use the tag

Additional problems with the older revision:

  • C# is not multiparadigm. It's OO. The wiki is the thing that's misleading. It has a few features that enable stuffing functions into variables, but it is definitely not a functional language. Functional languages are not imperative, and C# is definitely not equipped to avoid writing imperative code.
  • Telling people how to write questions is out of scope for a tag wiki.

Suggestion to solve these problems:

C# (pronounced "see sharp") is a high level, statically typed, object oriented programming language developed by Microsoft. C# code usually targets Microsoft's .NET family of tools and runtimes, which include the .NET Framework and .NET Core. Use this tag for questions about code written in C# or C#'s formal specification. Most questions also need a tag for the target .NET platform, such as [.net] (for the .NET Framework), [.net-core], or [.net-standard].

Reasoning:

  • It's important to give the reader some brief description of what we're talking about.
  • It's likely that people will be confused about the difference between .NET and C#, so this attempts to clarify that .NET is the tools and runtime while C# is the language.
  • Tag wikis should indicate when to use the tag.
  • Since most C# questions will be targeting a .NET platform and sometimes it matters which one, most C# questions will also need a tag indicating which platform is being targeted.

Possible improvements over this:

  • I don't like using the word "platform." I don't think it's a term MS uses. Any info about what terms MS uses when discussing the different tool sets and runtimes is appreciated.

Things I notice in the full wiki:

  • The the bit about "multiparadigm" needs to be removed there.
  • It claims dynamic enables "type inference," but that's not what it does. It disables static typing for that variable, preventing the compiler checks on type compatibility and member references.
  • I don't know why there's a bunch of info about which versions introduced certain keywords and the features that correspond to them. Maybe it should just talk about the features themselves, without making it a change log? An SO tag wiki seems like a bad place for a change log.
13
  • 8
    I agree you should not put how to write questions, but excerpt is tag guidance, it should help a diligent user to tag correctly, inform about tagging practices in tag etc. Your suggestion does not give this information. If I need a definition of C# I will check Wikipedia not SO tag guidance. Commented Sep 28, 2018 at 6:41
  • 4
    I would probably reject an edit like that with standard rejection reason "Does not provide guidance" Commented Sep 28, 2018 at 6:48
  • @PetterFriberg That's fine. Someone apparently thought this was a good idea; I'm just trying to work with what we have. I'm honestly not sure what guidance you could give; you use the tag if you're programming in the language. If you have ideas, please post them; I'll gladly upvote if it's on point. As for checking Wikipedia, it's wrong in this case. Obviously written by people trying to market the language; it's the source of this "multiparadigm" nonsense.
    – jpmc26
    Commented Sep 28, 2018 at 8:20
  • Maybe “[…] that run on .NET runtimes like .NET Framework and .NET Core”?
    – poke
    Commented Sep 28, 2018 at 9:06
  • @PetterFriberg Done, I think.
    – jpmc26
    Commented Sep 29, 2018 at 19:53
  • I don't think that you can tag format in an excerpt: you'll need to replace .net with just ".net", etc.
    – Cœur
    Commented Sep 30, 2018 at 1:49
  • @Cœur ....Seriously? Are you sure? Assuming it's correct: What is wrong with SO? You'd think that would've been implemented like 8 years ago.
    – jpmc26
    Commented Sep 30, 2018 at 4:18
  • @jpmc26 Tell people that tag excerpts do not support formatting
    – Cœur
    Commented Sep 30, 2018 at 5:22
  • 1
    @jpmc26, much better, excerpt primary use is to popup and give you guiadance while adding tag to questions, hence links are not useful, they should instead just give a good tooltip. Commented Sep 30, 2018 at 9:14
  • 1
    @Cœur What are your thoughts on writing it as [.net] and [.net-core] to indicate these are tag references? Or is there a way to reword it so we don't have to mention the tag names explicitly? Is there a norm around writing tag names in excerpts?
    – jpmc26
    Commented Sep 30, 2018 at 18:57
  • @PetterFriberg See above.
    – jpmc26
    Commented Sep 30, 2018 at 18:57
  • 1
    @jpmc26 you can look at popular controversial tags like excel-vba to note that they indeed use [tagname] to refer to other tags.
    – Cœur
    Commented Sep 30, 2018 at 19:11
  • @jpmc26 I'm fine with [], whatever makes it easy to understand for a diligent user. Commented Oct 1, 2018 at 6:13
2

I have suggested the following revision:

C# (pronounced "see sharp") is a high level, object-oriented programming language developed by Microsoft. Questions should include code examples, sufficient to reproduce the problem. Add extra tags, relevant to the used technology or library.

Any improvements are welcomed.

1
  • The programming language is not "managed." The language just happens to be compiled to bytecode by Microsoft's tools. That's a property of the compiler and runtime, not the language.
    – jpmc26
    Commented Sep 29, 2018 at 18:52

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .