History:Style Guideline: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(Updated the old explanations of the Official Style Guidelines; added a link to the Style Principle instead of copy/pasting them.)
Line 1: Line 1:
[[MusicBrainz]] has a lot of relational data. But you still have to type plain text in all the database fields. In order for the database to be in a good consistent shape, the [[Style Council]] has agreed on a certain ''style'' according to which such text should be entered.
[[MusicBrainz]] has a lot of relational data. But you still have to type plain text in all the database fields. In order for the database to be in a good consistent shape, the [[Style Council]] has agreed on a certain ''style'' according to which such text should be entered.


'''Note that the [[Style Principle]]s of [[MusicBrainz]] state:'''
'''Note that the Style Guidelines of [[MusicBrainz]] are not hard and fast rules, instead, the [[Style Principle]]s should always be used to determine the correct course of action.'''
# '''Follow [[Artist Intent]].'''
# '''If 1 is not applicable, use [[Consistent Original Data]].'''
# '''If both 1 and 2 are not applicable, follow the StyleGuidelines.'''


==Principal Guidelines==
==Principal Guidelines==


The following guidelines are available:
The following guidelines are available:

* [[Official Style Guideline]]s
; [[Official Style Guideline]]s
** This is a Wiki version of the [[Official Style Guideline]]s on the [http://musicbrainz.org/style.html website] which outline how the data in MusicBrainz should be formatted and organized. Being a [[Wiki Page]] it is more detailed and contains discussion, questions (and answers :-). It is also more up to date than the version on the website.
: The [[Official Style Guideline]]s are those guidelines that have been officially sanctioned by the [[Style Council]] and should usually be refered to whenever editing the data on [[MusicBrainz]]
* [[Capitalization Standard]]

** How to capitalize album and track titles. Since June 2004 we are working towards [[Internationalization|internationalization]]. This will give us language specific standards. [[Capitalization Standard]] lists all available standards for different languages.
; [[Capitalization Standard]]
* [[Classical Style Guide]]
: How to capitalize album and track titles. Since June 2004 we are working towards [[Internationalization|internationalization]]. This will give us language specific standards. [[Capitalization Standard]] lists all available standards for different languages.
** For classical music (or any music, where the composer is taken as the principal artist) different style rules apply, and different problems arise. These are all addressed in this section containing [[Classical Music FAQ]], [[Classical Style Guide]] and [[Talk:Classical Style Guide|ClassicalStyleGuideDiscussion]].

* [[Proposed Style Guideline]]s
; [[Classical Style Guide]]
** This is a place for new style guidelines to be proposed and discussed.
: For classical music (or any music, where the composer is taken as the principal artist) different style rules apply, and different problems arise. These are all addressed in this section containing [[Classical Music FAQ]], [[Classical Style Guide]] and [[Talk:Classical Style Guide]].

; [[Proposed Style Guideline]]s
: This is a place for new style guidelines to be proposed and discussed.


==Other Guidelines and Help==
==Other Guidelines and Help==


* [[Series Style Guideline]]s
; [[Series Style Guideline]]s
** These are guidelines that apply to a specific series of releases only, but not to all entities in general.
: These are guidelines that apply to a specific series of releases only, but not to all entities in general.

* If you have a question regarding an [[Odd Release]] you might want to look for it in [[Additional Metadata]]. If you find it there your question might already been answered. If you do not find it, you can ask on the [[Users Mailing List]]. When your problem has been solved, please list your solution there to help others that come after you.
* If you have a question regarding an [[Odd Release]] you might want to look for it in [[Additional Metadata]]. If you find it there your question might already been answered. If you do not find it, you can ask on the [[Users Mailing List]]. When your problem has been solved, please list your solution there to help others that come after you.
* You might also want to look at [[How Editing Works]] and the [[Editing Guideline]]s as well as [[How To Vote]].
* You might also want to look at [[How Editing Works]] and the [[Editing Guideline]]s as well as [[How To Vote]].

Revision as of 23:32, 27 July 2009

MusicBrainz has a lot of relational data. But you still have to type plain text in all the database fields. In order for the database to be in a good consistent shape, the Style Council has agreed on a certain style according to which such text should be entered.

Note that the Style Guidelines of MusicBrainz are not hard and fast rules, instead, the Style Principles should always be used to determine the correct course of action.

Principal Guidelines

The following guidelines are available:

Official Style Guidelines
The Official Style Guidelines are those guidelines that have been officially sanctioned by the Style Council and should usually be refered to whenever editing the data on MusicBrainz
Capitalization Standard
How to capitalize album and track titles. Since June 2004 we are working towards internationalization. This will give us language specific standards. Capitalization Standard lists all available standards for different languages.
Classical Style Guide
For classical music (or any music, where the composer is taken as the principal artist) different style rules apply, and different problems arise. These are all addressed in this section containing Classical Music FAQ, Classical Style Guide and Talk:Classical Style Guide.
Proposed Style Guidelines
This is a place for new style guidelines to be proposed and discussed.

Other Guidelines and Help

Series Style Guidelines
These are guidelines that apply to a specific series of releases only, but not to all entities in general.

Changing Guidelines

The style guidelines form a very balanced set of rules. Changing them is a slow and careful process. Since 2005-12 a new process for style changes is emerging. See these email threads, How To Change Style Guidelines, and also the older guide on How To Propose New Guidelines for details.

The Migration Guideline requires that major changes to the style guidelines be tested by Beta Editing on the Test Server, to figure out if it entails any major Soft Structure changes.