Difference between revisions of "History:Official Style Guideline"

From MusicBrainz Wiki
m (Cleaned some of the formatting up.)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The following style guidelines outline how the data in [[MusicBrainz]] should be formatted and organized. If you would like to participate in the editing process, please take a moment to review these guidelines. Please take a look at the [[Users Mailing List|UsersMailingList]] if you require assistance.
+
{{official style guideline}}
  
==About the Style Guidelines==
+
The following style guidelines outline how the data in MusicBrainz should be formatted and organized. If you would like to participate in the editing process, please take a moment to review these guidelines. If you require further assistance take a look at the [[Users Mailing List|users mailing list]].
  
The following are those [[Style Guidelines|StyleGuidelines]] that are officially sanctioned by the [[Style Council|StyleCouncil]].  There are currently two places to find these guidelines:
+
Please ''do not change the guidelines on your own''. If you have an idea for new a style guideline, or would like to suggest changes to an existing style guideline, please send a [[Proposals|proposal]] to the [[Style Mailing List|Style Council]].
* [http://musicbrainz.org/doc/OfficialStyleGuideline musicbrainz.org/doc/OfficialStyleGuideline]
 
:The [[WikiDocs]] version of this page.
 
* [http://wiki.musicbrainz.org/OfficialStyleGuideline wiki.musicbrainz.org/OfficialStyleGuideline]
 
:The wiki version of the style guidelines. These might include discussions or changes which are not official yet.  
 
  
Please ''do not change the guidelines themselves'', unless you are a member of the [[Style Council|StyleCouncil]], or you really know what you are doing. If you have ideas for new style guidelines or changes, please send them to the [[Style Mailing List|StyleMailingList]] (if you are new to [[MusicBrainz]], ask on the [[Users Mailing List|UsersMailingList]] first). They might then be added to  [[Proposed Style Guideline|ProposedStyleGuideline]]s and eventually be made an OfficialStyleGuideline by the [[Style Council|StyleCouncil]].  
+
==About the style guidelines==
 +
 
 +
The following [[Style Guidelines|style guidelines]] are those that have been officially sanctioned by the [[Style Council]]
 +
 
 +
There are currently two places to find these guidelines (for more information on the transclusion mechanism see [[WikiDocs]]):
 +
* On the MusicBrainz website at http://musicbrainz.org/doc/Official_Style_Guideline
 +
*: This version of the official style guidelines is to be used when editing the database.
 +
* On the MusicBrainz wiki at http://wiki.musicbrainz.org/Official_Style_Guideline
 +
*: This version of the official style guidelines may differ from the above and include modifications or revisions that have not been made official yet.
  
 
==The Guidelines==
 
==The Guidelines==
  
It's important to know that these are '''guidelines''', not strict rules. The [[Style Principle|StylePrinciple]]s explain when guidelines should be applied and when they should not. There are also officially sanctioned [[Exceptions To The Style Guidelines|ExceptionsToTheStyleGuidelines]].  
+
It's important to know that these are '''guidelines''', not strict rules. The [[Style Principle|style principles]] explain when guidelines should be applied and when they should not. There are also officially sanctioned [[Exceptions To The Style Guidelines|exceptions]] to the style guidelines.  
  
===Release Titles===
+
===Release titles===
  
 
The following guidelines apply to the [[Release Title|ReleaseTitle]] field:  
 
The following guidelines apply to the [[Release Title|ReleaseTitle]] field:  
; [[Subtitle Style|SubTitleStyle]]
+
; [[Subtitle Style|Subtitle style]]
: Use a colon (:) to separate parts of a title: "''[[Main Title|MainTitle]]: [[Subtitle|SubTitle]]''".  
+
: Use a colon (:) to separate parts of a title: "''[[Main Title|Main title]]: [[Subtitle|Subtitle]]''".  
  
; [[Disc Number Style|DiscNumberStyle]]
+
; [[Disc Number Style|Disc number style]]
: Indicate [[Disc Number|DiscNumber]]s like this: "''[[Main Title|MainTitle]] (disc 2)''".  
+
: Indicate [[Disc Number|disc numbers]] like this: "''[[Main Title|Main title]] (disc 2)''".  
: If each disc has an extra title do it like this: "''[[Main Title|MainTitle]] (disc 2: [[Disc Title|DiscTitle]])''".  
+
: If each disc has an extra title do it like this: "''[[Main Title|Main title]] (disc 2: [[Disc Title|Disc title]])''".  
 
: For bonus discs add "'' (bonus disc)''" to the end.  
 
: For bonus discs add "'' (bonus disc)''" to the end.  
: Individual singles released with a disc number appended to the title should be standardised as "''[[Main Title|MainTitle]] (disc 2)''".  
+
: Individual singles released with a disc number appended to the title should be standardised as "''[[Main Title|Main title]] (disc 2)''".  
  
; [[Series Number Style|SeriesNumberStyle]]
+
; [[Series Number Style|Series number style]]
: [[Volume Number|VolumeNumber]]s are special: append them with a comma like this: "''[[Main Title|MainTitle]], [[Volume Number|VolumeNumber]]''". See [[Volume Number Style|VolumeNumberStyle]] for specific details.  
+
: [[Volume Number|Volume numbers]] are special: append them with a comma like this: "''[[Main Title|Main title]], [[Volume Number|Volume number]]''". See [[Volume Number Style|volume number style]] for specific details.  
  
; [[Box Set Name Style|BoxSetNameStyle]]
+
; [[Box Set Name Style|Box set name style]]
 
: Box sets are done like this: "''(box 5, disc 2)''".  
 
: Box sets are done like this: "''(box 5, disc 2)''".  
  
; [[Untitled Bootleg Style|UntitledBootlegStyle]]
+
; [[Live Bootleg Style|Live bootleg style]]
: Untitled bootlegs should be labelled like this: "''2000-10-22: Las Vegas, NV, USA''".  
+
: Bootlegs should be labelled like this: "''2000-10-22: Las Vegas, NV, USA''".  
  
; [[Multiple Title Style|MultipleTitleStyle]]
+
; [[Multiple Title Style|Multiple title style]]
 
: Multiple releases on one disc and multiple songs on one track are separated by " / ". Yes, that's ''space, forward slash, space''.  
 
: Multiple releases on one disc and multiple songs on one track are separated by " / ". Yes, that's ''space, forward slash, space''.  
  
; [[EP Style|EPStyle]]
+
; [[EP Style|EP style]]
 
: If the word "''EP''" or "''E.P.''" is part of a title, it should be retained.  
 
: If the word "''EP''" or "''E.P.''" is part of a title, it should be retained.  
  
; [[Soundtrack Title Style|SoundtrackTitleStyle]]
+
===Track titles===
: A soundtrack should be given the same title as the film, and should not include extra detail such as "Original Motion Picture Soundtrack" or similar descriptive information. Set the [[Release Attribute|ReleaseAttribute]] to "Soundtrack".
 
 
 
===Track Titles===
 
  
; [[Versus Style|VersusStyle]]
+
; [[Versus Style|Versus style]]
 
: About the uses of "versus" and how we deal with them.  
 
: About the uses of "versus" and how we deal with them.  
  
; [[Remix Style|RemixStyle]]
+
; [[Remix Style|Remix style]]
 
: How we deal with remixes and other versions of tracks (such as demo versions, etc).  
 
: How we deal with remixes and other versions of tracks (such as demo versions, etc).  
  
; [[Data Track Style|DataTrackStyle]]
+
; [[Data Track Style|Data track style]]
 
: [[Data Track|DataTrack]]s are named "''[data track]''".  
 
: [[Data Track|DataTrack]]s are named "''[data track]''".  
  
; [[Untitled Track Style|UntitledTrackStyle]]
+
; [[Untitled Track Style|Untitled track style]]
 
: Untitled tracks are named "''[untitled]''".  
 
: Untitled tracks are named "''[untitled]''".  
 
: Silence tracks are named "''[silence]''".  
 
: Silence tracks are named "''[silence]''".  
 
: Unknown tracks are named "''[unknown]''".  
 
: Unknown tracks are named "''[unknown]''".  
  
; [[Series Number Style|SeriesNumberStyle]]
+
; [[Series Number Style|Series number style]]
: [[Part Number|PartNumber]]<code><nowiki></nowiki></code>s are special: append them with a comma like this: "''Title, [[Part Number|PartNumber]]''". See [[Part Number Style|PartNumberStyle]] for specific details.
+
: [[Part Number|Part numbers]] are special, append them with a comma like this: "''Title, [[Part Number|part number]]''". See [[Part Number Style|part number style]] for specific details.  
 
 
; [[Extra Title Information Style|ExtraTitleInformationStyle]]
 
: This is a list of information that should be omitted from [[Release Title|ReleaseTitle]]s and [[Track Title|TrackTitle]]s.  
 
  
; [[Track Attribute Style|TrackAttributeStyle]] (could be merged into the above [[Extra Title Information Style|ExtraTitleInformationStyle]])
+
; [[Extra Title Information Style|Extra title information style]]
: Enter mix names and other track attributes in parentheses after the title.  
+
: This is a list of information that should be omitted or included in [[Release Title|release titles]] and [[Track Title|track titles]].
  
 
===Artists===
 
===Artists===
  
; [[Featuring Artist Style|FeaturingArtistStyle]]
+
; [[Featuring Artist Style|Featuring artist style]]
: When two artists collaborate, file the track under the [[Primary Artist|PrimaryArtist]], and append the name of the [[Secondary Artist|SecondaryArtist]] to the [[Track Title|TrackTitle]] like this "''(feat. Everlast)''".
+
: When two artists collaborate, file the track under the [[Primary Artist|primary artist]], and append the name of the [[Secondary Artist|secondary artist]] to the [[Track Title|track title]] like this "''(feat. Everlast)''".  
 
 
; [[Release Artist Style|ReleaseArtistStyle]]
 
: This covers when to use one [[Primary Artist|PrimaryArtist]] and when to use [[Various Artists|VariousArtists]] as [[Release Artist|ReleaseArtist]] for a release. Note that the [[Classical Release Artist Style|ClassicalReleaseArtistStyle]] spells out different rules for classical music.  
 
  
; [[Unknown Artist Style|UnknownArtistStyle]]
+
; [[Release Artist Style|Release artist style]]  
: If the artist is unknown, file the release/track under the ''[unknown]'' artist.  
+
: This covers when to use one [[Primary Artist|primary artist]] and when to use [[Various Artists|various artists]] as [[Release Artist|release artist]] for a release. Note that the [[Classical Release Artist Style|classical release artist style]] spells out different rules for classical music.  
  
; [[No Artist Style|NoArtistStyle]]
+
; [[Special Purpose Artist|Special purpose artists]]
: Recordings that have no artist should be filed under ''[no artist]''. This would be appropriate for silence, bird song etc.  
+
: Several special artist listings ([anonymous], [data], [dialogue], [no artist], [unknown], and Various Artists) are approved for use when the artist is unknown, dialogue, nature sounds, data, etc.  See this guideline for details on these artists.
  
; [[Sortname Style|SortNameStyle]]
+
; [[Sortname Style|Sortname style]]
: Discusses how [[Artist Sort Name|ArtistSortName]]s should be used.  
+
: Discusses how [[Artist Sort Name|artist sort names]] should be used.
  
===General Guidelines===
+
===General guidelines===
  
; [[Capitalization Standard|CapitalizationStandard]]
+
; [[Capitalization Standard|Capitalization standard]]
 
: Discusses how titles should be capitalized in various languages.  
 
: Discusses how titles should be capitalized in various languages.  
  
; [[Classical Style Guide|ClassicalStyleGuide]]
+
; [[Classical Style Guide|Classical style guide]]
: Discusses how details relating to classical music should be stored (also can be applied to musicals). More specific details on [[Classical Release Artist Style|ClassicalReleaseArtistStyle]].  
+
: Discusses how details relating to classical music should be stored (also can be applied to musicals). More specific details on [[Classical Release Artist Style|classical release artist style]].  
  
; [[Miscellaneous Guideline|MiscellaneousGuideline]]s
+
; [[Miscellaneous Guideline|Miscellaneous guidelines]]
 
: Covers the little guidelines that aren't worthy of a whole wiki page all to themselves.  
 
: Covers the little guidelines that aren't worthy of a whole wiki page all to themselves.  
  
; [[Abbreviation Style|AbbreviationStyle]]
+
; [[Abbreviation Style|Abbreviation style]]
 
: Discusses our policy on abbreviations.  
 
: Discusses our policy on abbreviations.  
  
===Advanced Relationships===
+
===Release attributes===
 
 
; [[Member Of Band Relationship Style|MemberOfBandRelationshipStyle]]:
 
: If a [[Band Member|BandMember]] is usually known by a particular [[Performance Name|PerformanceName]], use this to link them to the band instead of their [[Legal Name|LegalName]].
 
 
 
===Release Attributes===
 
 
 
[[Release Attribute|ReleaseAttribute]]s define the type and status of an audio release and provide information about the contents of the release. Release attributes should apply to most of the tracks on the release. It's OK to have a couple of tracks that do not fit the release attribute, as long as the attribute applies to the release overall.
 
  
; [[Release Type|ReleaseType]]
+
[[Release Attribute|Release attributes]] define the type and status of an audio release and provide information about the contents of the release. Release attributes should apply to most of the tracks on the release. It's OK to have a couple of tracks that do not fit the release attribute, as long as the attribute applies to the release overall.  
: The Type of a release can be: Album, Single, EP, Compilation, Soundtrack, Spokenword, Interview, Audiobook, Live, Remix, or Other. See [[Release Attribute|ReleaseAttribute]] for a short summary and [[Release Type|ReleaseType]] for details.  
 
  
; [[Release Language|ReleaseLanguage]]
+
; [[Release Type|Release type]]
: The Language used in the [[Release Title|ReleaseTitle]] and [[Track Title|TrackTitle]]s.  
+
: A release can be set to one of the following release types: Album, Single, EP, Compilation, Soundtrack, Spokenword, Interview, Audiobook, Live, Remix, or Other. See [[Release Attribute|release attribute]] for a short summary and [[Release Type|release type]] for details.  
  
; [[Release Status|ReleaseStatus]]
+
; [[Release Language|Release language]]
: The Status of a release can be: Official, Promotion, or Bootleg. See [[Release Attribute|ReleaseAttribute]] for a short summary and [[Release Status|ReleaseStatus]] for details.  
+
: The language used in the [[Release Title|release title]] and [[Track Title|track titles]].  
  
[[Category:Style]] [[Category:Official Style]] [[Category:WikiDocs Page]]
+
; [[Release Status|Release status]]
 +
: A release can have one of the following statuses: Official, Promotion, or Bootleg. See [[Release Attribute|release attribute]] for a short summary and [[Release Status|release status]] for details.

Latest revision as of 18:39, 29 March 2012

Status: This Page is Glorious History!

The content of this page either is bit-rotted, or has lost its reason to exist due to some new features having been implemented in MusicBrainz, or maybe just described something that never made it in (or made it in a different way), or possibly is meant to store information and memories about our Glorious Past. We still keep this page to honor the brave editors who, during the prehistoric times (prehistoric for you, newcomer!), struggled hard to build a better present and dreamed of an even better future. We also keep it for archival purposes because possibly it still contains crazy thoughts and ideas that may be reused someday. If you're not into looking at either the past or the future, you should just disregard entirely this page content and look for an up to date documentation page elsewhere.

The following style guidelines outline how the data in MusicBrainz should be formatted and organized. If you would like to participate in the editing process, please take a moment to review these guidelines. If you require further assistance take a look at the users mailing list.

Please do not change the guidelines on your own. If you have an idea for new a style guideline, or would like to suggest changes to an existing style guideline, please send a proposal to the Style Council.

About the style guidelines

The following style guidelines are those that have been officially sanctioned by the Style Council.

There are currently two places to find these guidelines (for more information on the transclusion mechanism see WikiDocs):

The Guidelines

It's important to know that these are guidelines, not strict rules. The style principles explain when guidelines should be applied and when they should not. There are also officially sanctioned exceptions to the style guidelines.

Release titles

The following guidelines apply to the ReleaseTitle field:

Subtitle style
Use a colon (:) to separate parts of a title: "Main title: Subtitle".
Disc number style
Indicate disc numbers like this: "Main title (disc 2)".
If each disc has an extra title do it like this: "Main title (disc 2: Disc title)".
For bonus discs add " (bonus disc)" to the end.
Individual singles released with a disc number appended to the title should be standardised as "Main title (disc 2)".
Series number style
Volume numbers are special: append them with a comma like this: "Main title, Volume number". See volume number style for specific details.
Box set name style
Box sets are done like this: "(box 5, disc 2)".
Live bootleg style
Bootlegs should be labelled like this: "2000-10-22: Las Vegas, NV, USA".
Multiple title style
Multiple releases on one disc and multiple songs on one track are separated by " / ". Yes, that's space, forward slash, space.
EP style
If the word "EP" or "E.P." is part of a title, it should be retained.

Track titles

Versus style
About the uses of "versus" and how we deal with them.
Remix style
How we deal with remixes and other versions of tracks (such as demo versions, etc).
Data track style
DataTracks are named "[data track]".
Untitled track style
Untitled tracks are named "[untitled]".
Silence tracks are named "[silence]".
Unknown tracks are named "[unknown]".
Series number style
Part numbers are special, append them with a comma like this: "Title, part number". See part number style for specific details.
Extra title information style
This is a list of information that should be omitted or included in release titles and track titles.

Artists

Featuring artist style
When two artists collaborate, file the track under the primary artist, and append the name of the secondary artist to the track title like this "(feat. Everlast)".
Release artist style
This covers when to use one primary artist and when to use various artists as release artist for a release. Note that the classical release artist style spells out different rules for classical music.
Special purpose artists
Several special artist listings ([anonymous], [data], [dialogue], [no artist], [unknown], and Various Artists) are approved for use when the artist is unknown, dialogue, nature sounds, data, etc. See this guideline for details on these artists.
Sortname style
Discusses how artist sort names should be used.

General guidelines

Capitalization standard
Discusses how titles should be capitalized in various languages.
Classical style guide
Discusses how details relating to classical music should be stored (also can be applied to musicals). More specific details on classical release artist style.
Miscellaneous guidelines
Covers the little guidelines that aren't worthy of a whole wiki page all to themselves.
Abbreviation style
Discusses our policy on abbreviations.

Release attributes

Release attributes define the type and status of an audio release and provide information about the contents of the release. Release attributes should apply to most of the tracks on the release. It's OK to have a couple of tracks that do not fit the release attribute, as long as the attribute applies to the release overall.

Release type
A release can be set to one of the following release types: Album, Single, EP, Compilation, Soundtrack, Spokenword, Interview, Audiobook, Live, Remix, or Other. See release attribute for a short summary and release type for details.
Release language
The language used in the release title and track titles.
Release status
A release can have one of the following statuses: Official, Promotion, or Bootleg. See release attribute for a short summary and release status for details.