History:Bad Terminology: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(clarifications and additions (Imported from MoinMoin))
 
(answer (Imported from MoinMoin))
(8 intermediate revisions by the same user not shown)
Line 5: Line 5:
There are a number of groups of related terminology that could be improved by changing them. In approximately decreasing order of acceptance, they are:
There are a number of groups of related terminology that could be improved by changing them. In approximately decreasing order of acceptance, they are:
* [[Bad Terminology#moderate|Moderate / Moderation / Moderator / Automod]]
* [[Bad Terminology#moderate|Moderate / Moderation / Moderator / Automod]]
* [[Bad Terminology#ar|"Link"]] for [[Advanced Relationship|AdvancedRelationship]]
* [[Bad Terminology#ar|"Link"]] for [[Advanced Relationships|AdvancedRelationship]]
* [[Bad Terminology#cdid|CD Index ID]]
* [[Bad Terminology#cdid|CD Index ID]]
* [[Bad Terminology#album|Album / Release]]
* [[Bad Terminology#album|Album / Release]]
Line 35: Line 35:
===Contribute===
===Contribute===


There are, however, cases in which you cannot say "vote" or "edit". These are cases like "[[Moderation Note|ModerationNote]]" or "moderator" which refer to something that has to do with ''both'' editing and voting.
There are, however, cases in which you cannot say "vote" or "edit". These are cases like "[[Edit Note|ModerationNote]]" or "moderator" which refer to something that has to do with ''both'' editing and voting.


[[DJCK]] proposed the term "contribute" for this context. It avoids the problem that moderator has of having been used for too many things already and neatly encompasses everyone that uses the site for more than just tagging - developers who contribute code, editors contributing data, and voters contributing time to check that data. [[User:DonRedman|DonRedman]] and [[User:RobertKaye|RobertKaye]] do not edit or vote much but I don't think anyone would argue that you're not both major contributers.
[[DJCK]] proposed the term "contribute" for this context. It avoids the problem that moderator has of having been used for too many things already and neatly encompasses everyone that uses the site for more than just tagging - developers who contribute code, editors contributing data, and voters contributing time to check that data. [[User:DonRedman|DonRedman]] and [[User:RobertKaye|RobertKaye]] do not edit or vote much but I don't think anyone would argue that you're not both major contributers.
Line 43: Line 43:


However, [[Contribution Note|ContributionNote]] sounds terrible. Since the note is attached to ''edits'', it makes sense to
However, [[Contribution Note|ContributionNote]] sounds terrible. Since the note is attached to ''edits'', it makes sense to
* say ''[[Edit Note|EditNote]]'' instead of [[Mod Note|ModNote]] or [[Moderation Note|ModerationNote]].
* say ''[[Edit Note|EditNote]]'' instead of [[Edit Note|ModNote]] or [[Edit Note|ModerationNote]].


<span id="ar"></span>
<span id="ar"></span>
Line 52: Line 52:
There is even a (now fixed) [http://sourceforge.net/tracker/index.php?func=detail&aid=1194667&group_id=19506&atid=119506 Bug Report] to remedy this on the main site.
There is even a (now fixed) [http://sourceforge.net/tracker/index.php?func=detail&aid=1194667&group_id=19506&atid=119506 Bug Report] to remedy this on the main site.


Should this lead to a mass rename from [[Advanced Relationship|AdvancedRelationship]] to Relationship? --[[User:MartinRudat|MartinRudat]]
Should this lead to a mass rename from [[Advanced Relationships|AdvancedRelationship]] to Relationship? --[[User:MartinRudat|MartinRudat]]
<ul><li style="list-style-type:none">No. There is a bit about naming conventions at the bottom of [[Advanced Relationship Type|AdvancedRelationshipType]] under the heading "How to write advanced relationships documentation". Basically [[Advanced Relationships|AdvancedRelationships]] (in plural!) is the name of the feature. "Advanced" means ''not part of the database core'', and is thus a necessary adjective to differentiate from [[Core Relationships|CoreRelationships]]. NB: All of this has nothing to do with "Link" bing a bad terminology for "Relationship" :-) --[[User:DonRedman|DonRedman]]
<ul><li style="list-style-type:none">No. There is a bit about naming conventions at the bottom of [[Advanced Relationship Type|AdvancedRelationshipType]] under the heading "How to write advanced relationships documentation". Basically [[Advanced Relationships|AdvancedRelationships]] (in plural!) is the name of the feature. "Advanced" means ''not part of the database core'', and is thus a necessary adjective to differentiate from [[Core Relationships|CoreRelationships]]. NB: All of this has nothing to do with "Link" bing a bad terminology for "Relationship" :-) --[[User:DonRedman|DonRedman]]
</ul>
</ul>
Line 67: Line 67:


At present, I believe [[Disc ID|DiscID]] is used internally (certainly the [[Edit Type|EditType]]s refer to [[Disc ID|DiscID]]s), but CDID is often used elsewhere. --[[User:ZeroGravitas|ZeroGravitas]]
At present, I believe [[Disc ID|DiscID]] is used internally (certainly the [[Edit Type|EditType]]s refer to [[Disc ID|DiscID]]s), but CDID is often used elsewhere. --[[User:ZeroGravitas|ZeroGravitas]]
<ul><li style="list-style-type:none">''During the last release of the server, the references to CDID were replaced with DiscID on the edit pages'' --[[G0llum]]
<ul><li style="list-style-type:none">''During the last release of the server, the references to CDID were replaced with DiscID on the edit pages'' --[[User:Keschte|Keschte]]
</ul>
</ul>


Line 79: Line 79:


This helps eliminate the confusion between "Album Albums" and "Compilation" or "Live" etc. "Albums", so that Albums and Singles become types of release - this is almost done in a branch of CVS, but not on the main site.
This helps eliminate the confusion between "Album Albums" and "Compilation" or "Live" etc. "Albums", so that Albums and Singles become types of release - this is almost done in a branch of CVS, but not on the main site.
<ul><li style="list-style-type:none">''Which CVS branch? I would guess it's a bit dated by now.'' [[User:Dupuy|@alex]]
<ul><li style="list-style-type:none">''Which CVS branch? I would guess it's a bit dated by now.'' [[User:Dupuy|@alex]]<br/> ''Does MCs count as "albums"? I would never have called an MC release an album before I started working on [[MusicBrainz]]...'' --[[User:FrederikSOlesen|FrederikSOlesen]]
</ul>
</ul>


A Release should eventually be able to contain multiple Discs (what are currently called Albums) in order to properly represent multi-disc releases, box sets, etc.
A Release should eventually be able to contain multiple Discs (what are currently called Albums) in order to properly represent multi-disc releases, box sets, etc.
<ul><li style="list-style-type:none">''So is it Album -> Release or Album -> Disc? This is where the terminlogy gets tied to database changes that will come slowly, if at all.'' [[User:Dupuy|@alex]]
<ul><li style="list-style-type:none">''So is it Album -> Release or Album -> Disc? This is where the terminlogy gets tied to database changes that will come slowly, if at all.'' [[User:Dupuy|@alex]]
<ul><li style="list-style-type:none">''It's Album -> Release - a release can be an MC (or other forms of cassettes or non-discs).'' --[[User:FrederikSOlesen|FrederikSOlesen]]
<ul><li style="list-style-type:none">Not necessarily. The current terminology changes are album -> release. But if [[Next Generation Schema|NextGenerationSchema]] gets implemented, the current release "object" will get splitted into album (if we can't find a better word), release and medium. -- [[User:Shepard|Shepard]] 09:51, 16 August 2006 (UTC)
</ul>
</ul>
</ul>
</ul>


Line 119: Line 123:
* [[Auto-Moderation|AutoModeration]] => [[Auto-Edit|AutoEdit]]
* [[Auto-Moderation|AutoModeration]] => [[Auto-Edit|AutoEdit]]
* [[Auto Mod Nomination|AutoModNomination]] => [[Auto Editor Nomination|AutoEditorNomination]]
* [[Auto Mod Nomination|AutoModNomination]] => [[Auto Editor Nomination|AutoEditorNomination]]
* [[Mod Note|ModNote]], [[Moderation Note|ModerationNote]] => [[Edit Note|EditNote]]
* [[Edit Note|ModNote]], [[Edit Note|ModerationNote]] => [[Edit Note|EditNote]]
* [[Commonly Used Moderation Notes|CommonlyUsedModerationNotes]] => [[Commonly Used Edit Notes|CommonlyUsedEditNotes]]
* [[Commonly Used Moderation Notes|CommonlyUsedModerationNotes]] => [[Commonly Used Edit Notes|CommonlyUsedEditNotes]]
* [[Moderation FAQ|ModerationFAQ]] => [[Editing FAQ|EditingFAQ]]
* [[Moderation FAQ|ModerationFAQ]] => [[Editing FAQ|EditingFAQ]]
* [[Moderation Guide|ModerationGuide]] => [[Editing Guide|EditingGuide]]
* [[Moderation Guide|ModerationGuide]] => [[Editing Guide|EditingGuide]]
* [[Moderation Philosophy|ModerationPhilosophy]] => [[Editing Philosophy|EditingPhilosophy]]
* [[Moderation Philosophy|ModerationPhilosophy]] => [[Editing Philosophy|EditingPhilosophy]]
* [[Moderator Privacy|ModeratorPrivacy]] => [[Editor Privacy|EditorPrivacy]]
* [[Moderator Privacy|ModeratorPrivacy]] => [[Editor Privacy|EditorPrivacy]] [[Image:Checkmark.png]] -- [[User:Keschte|Keschte]]
* [[Subscribe To Moderator|SubscribeToModerator]] => [[Subscribe To Editor|SubscribeToEditor]]
* [[Subscribe To Moderator|SubscribeToModerator]] => [[Subscribe To Editor|SubscribeToEditor]]



Revision as of 09:51, 16 August 2006

Problems with Terminology used in MusicBrainz

There are a number of groups of related terminology that could be improved by changing them. In approximately decreasing order of acceptance, they are:



Moderate => Edit / Vote / Contribute (depending on context)

  • The most popular of the proposed changes; the first two points have largely been implemented on the Wiki
  • Say edit instead of moderate/moderation if it means edit.
  • Say vote instead of moderate/moderation if it means vote.
  • Say contributor/contribution instead of moderator/moderation, when it means both. Also see MusicBrainzContributor

Edit and Vote

We try to say "edit" or "vote" instead of "moderate" wereever this is possible. The term "modertor" comes from a different context, that does not apply to MusicBrainz and it is terribly unspecific. In full detail this means:

  • Say edit (verb) instead of moderate, if it applies to changing the data.
  • Say edit (noun) instead of moderation.
  • Say voting instead of moderating if it applies to voting.
  • Say AutoEdit or AutoApprovedEdit instead of AutoModeration, or worse even AutoMod.
  • Say editor instead of moderator, if it applies to changing the data.
  • Say AutoEditor instead of AutoModerator.

Contribute

There are, however, cases in which you cannot say "vote" or "edit". These are cases like "ModerationNote" or "moderator" which refer to something that has to do with both editing and voting.

DJCK proposed the term "contribute" for this context. It avoids the problem that moderator has of having been used for too many things already and neatly encompasses everyone that uses the site for more than just tagging - developers who contribute code, editors contributing data, and voters contributing time to check that data. DonRedman and RobertKaye do not edit or vote much but I don't think anyone would argue that you're not both major contributers.

This means:

  • Say contributor instead of moderator, if it applies to more than only voting or only editing.

However, ContributionNote sounds terrible. Since the note is attached to edits, it makes sense to

Link -> Relationship

Please do not call AdvancedRelationships "Links". Don't say "Link type" or the like. Just say relationship.

There is even a (now fixed) Bug Report to remedy this on the main site.

Should this lead to a mass rename from AdvancedRelationship to Relationship? --MartinRudat

  • No. There is a bit about naming conventions at the bottom of AdvancedRelationshipType under the heading "How to write advanced relationships documentation". Basically AdvancedRelationships (in plural!) is the name of the feature. "Advanced" means not part of the database core, and is thus a necessary adjective to differentiate from CoreRelationships. NB: All of this has nothing to do with "Link" bing a bad terminology for "Relationship" :-) --DonRedman

CD Index ID => Disc ID

  • A more recent proposal, this is non-controversial and already in wide use

CDID -> DiscID

I propose that we use DiscID in preference to CD Index ID (CDID). Someday it will be possible to generate DiscIDs for MusicDVDs, so we don't want to be tied to "CD"s. This would also avoid the use of a 4 letter acronym!

At present, I believe DiscID is used internally (certainly the EditTypes refer to DiscIDs), but CDID is often used elsewhere. --ZeroGravitas

  • During the last release of the server, the references to CDID were replaced with DiscID on the edit pages --Keschte

Album => Release

  • While popular, this is tightly coupled with various database change propsals like ReleaseGroups that haven't really been taken up

Album -> Release

This helps eliminate the confusion between "Album Albums" and "Compilation" or "Live" etc. "Albums", so that Albums and Singles become types of release - this is almost done in a branch of CVS, but not on the main site.

  • Which CVS branch? I would guess it's a bit dated by now. @alex
    Does MCs count as "albums"? I would never have called an MC release an album before I started working on MusicBrainz... --FrederikSOlesen

A Release should eventually be able to contain multiple Discs (what are currently called Albums) in order to properly represent multi-disc releases, box sets, etc.

  • So is it Album -> Release or Album -> Disc? This is where the terminlogy gets tied to database changes that will come slowly, if at all. @alex
    • It's Album -> Release - a release can be an MC (or other forms of cassettes or non-discs). --FrederikSOlesen
      • Not necessarily. The current terminology changes are album -> release. But if NextGenerationSchema gets implemented, the current release "object" will get splitted into album (if we can't find a better word), release and medium. -- Shepard 09:51, 16 August 2006 (UTC)

Release -> Release Date

We currently use the word Release to indicate a release date (in a country). An actual release would include the RecordLabel and the media. Or be a replacement for 'album' (see above).

  • I'm not sure what should happen to what is currently called "Release information" or "Releases", which consists of dates, countries of and possibly types (CD, Vinyl, Tape etc.) of release. --RjMunro
    • The current release information should become attributes of a Release, including other data such as ASIN, BarCodes, and other unique identifiers. --Agrundma
      • Calling them "attributes" is confusing because we currently use these for (Single, Official, etc.). I prefer "Release Data" -- not date -- because there's a country (and maybe media type, UPC, etc.) as well. @alex
    Please see ReleaseGroups for some related notes on usage of terminology, particular regarding Album and Release. As it stands there doesn't appear to be a good term for "one piece of media which contains a number of audio tracks" that doesn't have another common meaning in the music industry (Album and Release both have multiple uses). It would be nice to find a term that won't be potentially ambigious. --TarragonAllen 2004-06-07


Karma System => Editor Rating

  • People seem to agree not to use the term "Karma System", but since there is no such system in place, it's somewhat moot. Now JohnRamsay has raised the issue again, I do not really understand why. Maybe we interpret the past discussions differently? --DonRedman (pretty confused)

Karma -> EditorRating

Again, it's inherited from slashdot. It's a slashdotism, not a real use of the word. When I first showed a friend of mine the SurvivalOfTheFittest proposal, he said "Yuk... This page uses words like paradigm and Karma" and was immediately put off. This person owns a company that does things lots of design for usability etc. so he knows what he is talking about.

  • What is better: EditorRating or EditorRanking? English is not my native language, so could please someone else decide by creating one of the two pages. --DonRedman Rating is a measurment. Ranking is position in a list. Ranks go first, second, third etc. There's no reason not to have both. Currently, we have several rankings on the site - top moderators ever, top moderators per week, top voters ever, top voters per week. We could use these to help generate ratings, and/or we could have rankings based on ratings. --RjMunro I'd go with 'rating' for just that reason, Rj. With ranking, someone has to be at the top, regardless of qualification. Ratings are independent of other people, just a statement of this person's qualifications. So if we are aiming at a system that rates people according to their editing skill, and voting accuracy, then rating is what we want. The rankings for top voter/editor/etc., remain great incentive to do more, though. --Jinxie Agreed 100% -- rating sounds like the right approach --Ruaok Maybe we should also have EditorRanting...! Ratings are more useful because they allow other moderators to gauge the reliabiltiy of the mod by getting a sense of the depth and breadth of the moderators edits in the past. Of course the numbers skew at either end of the spectrum. There should be a minimum number of moderations before rating starts or possible starting all mods with 100 points and max at 250 points or zero. If a time factor was introduced then time would heal all wounds moving all mods back to 100 over time. It would give those who start out misguided but who learn by trial and error a chance to not just scrap the login ID and start over. Look at the system E-Bay employs alerts all buyers to new and inexpereinced sellers and rewards the long-term consistent service providers.

What about a "member since" star (or similar) system for loyality growing/ bragging rights, instead of mod ratings, since competition among moderators is counter-productive. There are also the 'pieces of flare' reward systems that some forums use to recognize above average posters. --JohnRamsay

Pages to Rename

Difficult

  • The content can be moved by hand from AutoModerator to AutoEditor and the links within the wiki can be fixed. Fixing links outside the wiki (including redirects from /wd/AutoModerator and maybe /mod/automodlist.html) will be harder. Finally AutoModerator could be de-wikidocized at WolfSong's discretion. --DonRedman