History:Official Style Guideline: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
m (Cleaned some of the formatting up.)
(Terminology => terminology)
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.
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]].


Please ''do not change the guidelines on your own'', unless you are a member of the [[Style Council]], 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|style mailing list]] (if you are new to MusicBrainz, ask on the [[Users Mailing List|users mailing list]] first). They might then be added to the list of [[Proposed Style Guideline|proposed style guideline]]s and eventually be made an official style guideline by the [[Style Council]].
==About the Style Guidelines==


==About the style guidelines==
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:
* [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.


The following [[Style Guidelines|style guidelines]] are those that have been officially sanctioned by the [[Style Council]].
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]].

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]]
; [[Untitled Bootleg Style|Untitled bootleg style]]
: Untitled bootlegs should be labelled like this: "''2000-10-22: Las Vegas, NV, USA''".
: Untitled 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]]
; [[Soundtrack Title Style|Soundtrack title style]]
: 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".
: 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|release attribute]] to "Soundtrack".


===Track Titles===
===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 sumber 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]]
; [[Extra Title Information Style|Extra title information style]]
: This is a list of information that should be omitted from [[Release Title|ReleaseTitle]]s and [[Track Title|TrackTitle]]s.
: This is a list of information that should be omitted from [[Release Title|release titles]] and [[Track Title|track titles]].


; [[Track Attribute Style|TrackAttributeStyle]] (could be merged into the above [[Extra Title Information Style|ExtraTitleInformationStyle]])
; [[Track Attribute Style|Track attribute style]] (could be merged into the above [[Extra Title Information Style|extra title information style]])
: Enter mix names and other track attributes in parentheses after the title.
: Enter mix names and other track attributes in parentheses after the title.


===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]]
; [[Release Artist Style|Release artist style]]
: 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.
: 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.


; [[Unknown Artist Style|UnknownArtistStyle]]
; [[Unknown Artist Style|Unknown artist style]]
: If the artist is unknown, file the release/track under the ''[unknown]'' artist.
: If the artist is unknown, file the release/track under the ''[unknown]'' artist.


; [[No Artist Style|NoArtistStyle]]
; [[No Artist Style|No artist style]]
: Recordings that have no artist should be filed under ''[no artist]''. This would be appropriate for silence, bird song etc.
: Recordings that have no artist should be filed under ''[no artist]''. This would be appropriate for silence, bird song etc.


; [[Sortname Style|SortNameStyle]]
; [[Sortname Style|Sortname style]]
: Discusses how [[Artist Sort Name|ArtistSortName]]s should be used.
: Discusses how [[Artist Sort Name|ArtistSortName]]s 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 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.


; [[Release Type|ReleaseType]]
; [[Release Type|Release type]]
: 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.
: 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 Language|ReleaseLanguage]]
; [[Release Language|Release language]]
: The Language used in the [[Release Title|ReleaseTitle]] and [[Track Title|TrackTitle]]s.
: The language used in the [[Release Title|release title]] and [[Track Title|track titles]].


; [[Release Status|ReleaseStatus]]
; [[Release Status|Release status]]
: 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.
: 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.


[[Category:Style]] [[Category:Official Style]] [[Category:WikiDocs Page]]
[[Category:Style]] [[Category:Official Style]] [[Category:WikiDocs Page]]

Revision as of 21:15, 27 December 2009

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, unless you are a member of the Style Council, 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 (if you are new to MusicBrainz, ask on the users mailing list first). They might then be added to the list of proposed style guidelines and eventually be made an official style guideline by 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)".
Untitled bootleg style
Untitled 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.
Soundtrack title style
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 to "Soundtrack".

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 sumber 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 from release titles and track titles.
Track attribute style (could be merged into the above extra title information style)
Enter mix names and other track attributes in parentheses after the title.

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.
Unknown artist style
If the artist is unknown, file the release/track under the [unknown] artist.
No artist style
Recordings that have no artist should be filed under [no artist]. This would be appropriate for silence, bird song etc.
Sortname style
Discusses how ArtistSortNames 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.