New Tag Guidelines

post by Ruby · 2020-07-09T16:45:28.435Z · LW · GW · 2 comments

Contents

  When to create a tag
  How to name a tag
  Writing tag descriptions
    Opening sentence
    Related Tags / See also
    Tone
    [Optional] Examples
    [Optional] Quotes
None
2 comments


Don't worry too much about any of this. Feel free to create a tag, and if it's no good or needs some work, the mods or other users will take care of it.

When to create a tag

Many tags don’t exist simply because no one got around to creating them.

The purpose of tags is to help people find (or avoid) related clusters of content. When such a cluster exists but has no tag, then it is appropriate to create a tag for it. 

Good tags need to strike a balance between applying to enough posts to be worth creating, but not so many as to be useless. For example, so many posts on LessWrong have reductionist models that a reductionistic models tag would apply to too many things. (By too many, I mean hundreds.)

A good heuristic is that tag ought to have three high-quality posts, preferably written by two or more authors. 

  1. Tags are for collecting related clusters of posts.
  2. A good tag should apply to at least a few posts (~minimum 3) but not too many (e.g. shouldn’t apply to hundreds of LessWrong posts).
  3. Caution should be used when creating a tag that heavily overlaps with an existing tag. In such cases, mods or experienced taggers might weigh in how to best carve up concept-space.

How to name a tag

Names are one of the primary ways that people find tags, so it’s important to name a tag in a way that will be intuitive to most people. What would most people search for? Affect might be the more technical term, but most people will probably search for Emotions, making it a better tag name.

Further, many people will apply a tag to posts without reading a description or carefully looking over the currently tagged posts. This can easily cause the tag to “drift” from its intended usage. To prevent this, the tag name should try to be very explicit about the cluster it’s pointing to.

Many tags are best described by a name that is somewhat overloaded, e.g. Relationships. Here it is good to use Wikipedia style disambiguation, e.g. Relationships (Interpersonal) vs Relationships (Romantic). Putting the modifier in the disambiguation after the main word means people look for “R”, the first letter of the main word, still find it easily.

  1. Name the tag in a way that will be intuitive to most people for finding that concept.
  2. Have the tag name convey the precise concept, don’t assume it will be obvious to others.
  3. Use disambiguation where necessary.

Writing tag descriptions

Tag descriptions define the cluster of posts the tag is supposed to collect. It’s important for helping future taggers decide whether or not something belongs, and sets expectations of readers about what they’ll find.

Opening sentence

The opening sentence of a tag description should include the tag name or approximately the tag name, bolded, in a way that defines the cluster, e.g.:

  • A bucket error is when someone mistakenly lumps together multiple concepts which are in fact distinct and can very independently. It is a fallacy of compression [LW · GW].

If a concept is likely to have multiple search terms, it is good to put these in the description. This will cause them to be found via search even if the primary tag name is different. This is a solution when multiple tag names seem appropriate.

People interested in one tag are often also interested in “neighboring” tags. Moreover, people searching for a particular concept will often first hit upon a related concept. For this reason, it is important for all tags to include links to other tags in nearby concept space. This is accomplished with a See Also section.

For example, the tag for Productivity should contain a See Also section that links to the tags for Akarasia, Willpower, Motivations, and Practical. Practical is roughly the “parent” tag for Productivity and should be included too.

Tone

Feel free to be more experimental with your tone and emphasis than you would have to be on places like Wikipedia. We are not writing for an audience that is as broad, and we are less constrained to keep everything really defensible, so you can err on the side of writing things the way you would say it. However, it's also fine to stick with an encyclopedic tone if the muse doesn't strike you.

[Optional] Examples

For many, but not all, tags it is useful to provide examples of the concept in the description. For example, the tag for Gears-Level Understanding lists a few examples of such examples. [Even better is to also list some counter-examples.]

[Optional] Introductory Content, Sequences, and External Resources

It can be good to have a section in a tag description pointing out the best introductory or defining material for a concept. E.g., the concept of Slack was introduced in the post of the same name [LW · GW].

Also, it is not currently possible to tag Sequences or external links, so if some of those are relevant to a tag, it is good to include them under a Resources section.

Generally, the list of tags can’t provide context on the posts, and the tag description area is an opportunity to do that. Not required, but good.

[Optional] Quotes

A good quote can spice up a tag description. Including this after the opening paragraph is a good way to go.

  1. The opening sentence should use the bolded tag name (approximately) to define the concept.
  2. Include a list of “neighboring” tags in a See Also section.
  3. Examples are good when defining a concept (including negative examples).
  4. Consider highlighting or linking to key resources for the concept, especially Sequences and external resources that can’t be tagged.
  5. Quotes!

2 comments

Comments sorted by top scores.

comment by Jacob Lagerros (jacob-lagerros) · 2020-07-14T23:25:36.925Z · LW(p) · GW(p)

I just ran into a tagging conflict. (I made a "Debate (AI safety technique)" tag, and noticed there was already an "AI safety via debate" tag.)

I came here to look for best practices for tagging conflicts, but couldn't find any. Letting you know in case you want to add some words about that.

Replies from: Ruby
comment by Ruby · 2020-07-15T00:43:55.604Z · LW(p) · GW(p)

Thanks for flagging this. It's a good question – and a good problem to have – means lots of people tagging. 

We haven't discussed it much as a team, but the following is the procedure I'd unilaterally propose:

In the case that it seems two tags are in conflict.

  1. A determination needs to be made on whether the two tags are in fact really the same concepts or in fact two separate (but closely related) concepts.
    1. If they actually appear to actually be the same concept, then people should figure out the best name for the concept (ideally on Talk Pages which will hopefully ship soon) and then the tags should be merged (ideally via tag-merging tech that we build, but possibly a bit more manual or hacky right now).
    2. If the tags are close but not related: a) some reflection on the ontology in the space might be warranted to ensure good factorization, b) The tag descriptions should each describe the bounds of each tag and its relationship to its neighbor, c) posts in each tag should be reviewed for proper membership.
  2. All else equal, preference will be given to tags which have more helpful descriptions defining them.