Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Meta

Comments on Tag naming guidelines.

Parent

Tag naming guidelines.

+3
−0

I've done a lot of work on tags lately and I'd like to share with the community some thoughts about the way tags should be named so that maybe it could become part of the FAQ and so hopefully lead to a more uniform tagging practice.

  • Acronyms should be spelled in all uppercase. This to avoid confusion with possible words (e.g. led vs. LED, can vs. CAN) and to make them stand out.

  • The main tag for acronyms should be the acronym itself, not the spelled-out form. This latter should be added as a synonym, i.e. don't leave an acronym tag lacking the spelled-out form, do add it as a synonym. For example LED (tag name) and light-emitting-diode (synonym), not vice versa. This because almost always the acronym is more recognizable and it is what most people know about (some people don't even know what an acronym stands for). Moreover, it is shorter and this is good for the UI presentation. Spelled-out form(s) should always be added (as synonyms) to avoid another, separate tag to be created by another user.

  • Otherwise tags should be all lowercase words separated by hyphens. This to ensure uniformity and wildly varying capitalization differences. This should be valid also for spelled-out acronyms, e.g. LED, but light-emitting-diode, not Light-Emitting-Diode.

  • Exception: Only a person's name should be capitalized. This to convey the information that a word is not some technical term, but it is the name of a person. This can be important because people with different linguistic backgrounds can be misled. For example, Darlington-pair and not darlington-pair, because of Mr.Darlington not being some funny English word whose meaning eludes the reader. If some English native speaker is not convinced, try it out with some non-English name: Giacoletto-model, Dirac-delta, Popov-method, Routh-method, Ohm-law, Gauss-theorem (try to forget for a moment you maybe already know those people from your past studies and try to picture their name as a "plain" English word).

  • The words should always be spelled out in singular form. This to avoid a mixup of singular and plural tags. E.g. LED and not LEDs, transistor and not transistors, operational-amplifier and not operational-amplifiers. This could be debatable, but IMO its the most sensible choice, since most terms make sense also in singular, but the contrary is not always true. There can be exceptions to this rule when the tag without the plural doesn't make sense, for example Maxwell-equations and not Maxwell-equation (they are more than one), but Shockley-equation (it's just that one). The same for Kirchhoff-laws and not Kirchhoff-law.

  • Saxon genitives should be suppressed. This to avoid entering tags with an apostrophe and, if someone entered the tag without the apostrophe, to confuse it with a plural form (see previous rule). E.g. Kirchhoff-laws and not Kirchoffs-laws or Kirchoff's-laws, Maxwell-equations and not Maxwells-equations or Maxwell's-equations, Gauss-theorem and not ... what? Gausss-theorem? Gausses-theorem? Gauss'-theorem? Simply drop the genitive and be done with it, much less hassle and much more uniformity.

  • No adjective-only tags, they can be very misleading. For example, what does binary (actual tag) refer to? Binary numbers? Binary transmission? The same goes for serial (Communication? Interface? Bus? Serial number?), adjustable (Regulator? Parameter?), linear (Model? System? Amplifier? Regulator?), thermal (Protection? Resistance? Design?), resettable (System? Fuse? Protection?) or electrical!

  • No ambiguous tags. This is similar to the previous rule, but its applicable to nouns. Whereas adjective-only tags are almost always a problem, single-noun tags can be perfectly fine. However some nouns, often used as adjectives with other nouns, can have the same problems. For example: flyback (Transformer? Power-supply?), high-speed (Design? Opamp? Signal? Communication? Bus?). And then there are nouns so general to be ambiguous in itself zero (The number? The root of an equation? "Zero" as in "pole-zero diagram"? Some kind of reference level?).

The previous were essentially hard-and-fast rules that are easy to check without too much thinking, except for some corner cases. I devised them based on common sense, engineering practice and the premise that tags should help group questions with somewhat similar topics.

In other words, tags shouldn't be some kind of "keyword" systems that just helps in searching a question. They should convey "structure". Please correct me if I'm wrong on this and I have misunderstood the feature.


EDIT (numeric values in tags)

Because of the posts of Olin Lathrop and Lundin I realized my proposed guidelines missed something important: a rule about quantities. I propose the following to be added.

  • Tag names containing numeric values should be avoided if possible. That's because in general they don't convey particular structure to the questions. If a value is central to a set of questions it probably already has a name (e.g. π, ε0).

  • If a tag must contain a numeric value, it should contain the proper SI unit symbol, with correct capitalization as mandated by SI (e.g. 4mA, 12V). The ASCII dot "." must be used as decimal separator (e.g. 3.3V) and the ASCII hyphen "-" must be used if a range of values needs to be specified (e.g. 4-20mA-loop).

  • A tag containing a numeric value should also contain other words to better specify what the value refers to. E.g. 4-20mA-loop, not 4-20mA; 12V-system, not 12V; 3.3V-tolerant, not 3.3V.

I'd like to avoid EE "jargon" values like 3V3 or 4R7 to represent 3.3V or 4.7Ω. This could be confusing for the newbie (remember, tags should avoid ambiguities and be as clear as possible).

As for SI prefix and units that can't be represented with basic ASCII characters, I think we should suspend our judgement until more information is gathered from tech staff.

Olin suggested to use HTML entities like &mu; for μ and &Omega; for Ω, which would be good in principle. However I feel there could be technical problems in some browsers and users may not be aware of what an HTML entity is. If someone experienced problems with entities they could bring more harm than good, with people trying to find workarounds that could mess-up tags.

For example, I think I read somewhere any Unicode "char" could be used in tags. So someone could use different code points to represent, say, Ω. In fact Unicode has Ω (U+03A9 GREEK CAPITAL LETTER OMEGA), but also (among others) 𝞨 (U+1D7A8 MATHEMATICAL SANS-SERIF BOLD ITALIC CAPITAL OMEGA), Ω (U+2126 OHM SIGN). Moreover, even HTML entities are not unique: there is also &ohm; Ω. So using entities could be like opening a big can of worms.

Note also that entities and Unicode chars might mess-up the sorting algorithm used to display the tag pages.

Unless we explicitly spell-out what entities are allowed and what's their use, we could have problems. In a way I would feel safer if we restricted the usable chars to (printable) ASCII alone.

So 1μF would be written as 1uF and 1MΩ would be written as 1Mohm [1], as ugly as that may be (at least it is guaranteed to work and it is predictable).

BTW, some standards also allow this explicitly, as mentioned in these Wikipedia pages:

micro symbol

Ohm symbol


  1. "ohm" lowercase and singular, as is mandated by SI for the name of units, even if they are derived from people's name. ↩︎

History
Why does this post require moderator attention?
You might want to add some details to your flag.
Why should this post be closed?

1 comment thread

Nicely thought out, well done. (3 comments)
Post
+2
−0

Additions:

  • Do not use company names in tags. Questions should be about specific products, not about companies. Furthermore, silicon companies merge/split and purchase each other all the time, so company tags will quickly become outdated.

    For example, questions about STM32 should be tagged STM32 not "ST". Questions about AVR should be tagged AVR/ATMega not "Atmel"/"Microchip". Questions about ARM cores should be tagged according to the specific core Cortex-M0 etc, not "ARM" (way too broad).

  • Do not use exact part numbers in tags. Use the family name or component type that the part belongs under.

    A tag such as "STM32F302CC" is too specific - by all means do include the exact part number in the question (with a link to the datasheet) and schematics, but do not drag in specific sub-families and part numbers into the tag structure. In this case even "STM32F" or "STM32F3" is too specific and doesn't really add much meaningful information. There are thousands of microcontrollers out there and if we are to create a tag for each and every family, it will become messy.

    Instead use the tag STM32 - the family name. Or you could use microcontroller to just indicate the type of IC. Similarly, use RS232-transceiver, not "MAX232".

    A potentially valid exception to this rule is standard IC where multiple vendors exist, like 74HC parts.

History
Why does this post require moderator attention?
You might want to add some details to your flag.

1 comment thread

I completely agree. In particular, for MCUs, the general architecture like `AVR` or `PIC` (or STM?... (1 comment)
I completely agree. In particular, for MCUs, the general architecture like `AVR` or `PIC` (or STM?...
Lorenzo Donati‭ wrote 9 months ago

I completely agree.

In particular, for MCUs, the general architecture like AVR or PIC (or STM? is that a known designation for a general architecture of ST MCUs? I don't know), can be a good starting point under the MCU tag (people may be searching for questions about a general architecture). As children tags you can put specific broad variants of those architectures (like PIC32, AVR, AVR32, or STM32).

I agree that specific parts are usually too specific. The only exception might be if they are so overwhelmingly widespread and known (e.g. the ATmega328P in the ubiquitous Arduino boards) that questions about that specific part may become common and numerous.