Difference between revisions of "History:Style Guideline"

From MusicBrainz Wiki
Jump to navigationJump to search
((Imported from MoinMoin))
 
 
(32 intermediate revisions by 7 users not shown)
Line 1: Line 1:
  +
{{official style guideline|principle=1}}<br/>
=Style Guidelines=
 
   
[[MusicBrainz]] has a lot of formalized data. But in all these formalized fields you still type plain text. In order for the database to be in a good shape, we have agreed on a certain ''style'' in which to write this text.
+
[[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|StylePrinciple]]s of [[MusicBrainz]] state:'''
+
'''Note that the Style Guidelines of [[MusicBrainz]] are not hard and fast rules, instead, the [[Style Principle]]s should be used to determine the correct course of action.'''
# '''Follow [[Artist Intent|ArtistIntent]].'''
 
# '''If 1 is not applicable, use [[Consistent Original Data|ConsistentOriginalData]].'''
 
# '''If both 1 and 2 are not applicable, follow the StyleGuideline<code><nowiki></nowiki></code>s.'''
 
   
  +
==Principal Guidelines==
===OfficialStyleGuidelines===
 
   
  +
The following guidelines are available:
<ul><li style="list-style-type:none">This is a Wiki version of the [[Official Style Guideline|OfficialStyleGuideline]]s which outline how the data in [[MusicBrainz]] should be formatted and organized. Being a [[Wiki Page|WikiPage]] it is more detailed and contains discussion, questions (and answers :-). ''(This section is currently being worked on, so beware!)''
 
</ul>
 
   
  +
; [[Official Style Guideline]]s
===CapitalizationStandard===
 
  +
: 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]]s
<ul><li style="list-style-type:none">How to capitalize album and track titles. Since June 2004 we are working towards [[Internationalization|InterNationalization]]. This will give us language specific standards. See [[Capitalization Standard|CapitalizationStandard]] for a list of available standards.
+
: 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.
</ul>
 
   
  +
; [[Classical Style Guide]]s
===ClassicalStyleGuide===
 
 
: 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]].
   
  +
; [[Proposals#Style_Proposals|Proposed Style Guidelines]]
<ul><li style="list-style-type:none">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|ClassicalMusicFAQ]], [[Classical Style Guide|ClassicalStyleGuide]] and [[Talk:Classical Style Guide|ClassicalStyleGuideDiscussion]].
 
 
: This is a place for new style guidelines to be proposed and discussed.
</ul>
 
   
  +
==Other Guidelines and Help==
===ProposedStyleGuidelines===
 
   
  +
; [[Series Style Guideline]]s
<ul><li style="list-style-type:none">This is a place for new style guidelines to be proposed and discussed. [[Proposed Style Guideline|ProposedStyleGuideline]].
 
  +
: These are guidelines that apply to a specific series of releases only, but not to all entities in general.
</ul>
 
  +
; [[How Editing Works]]
  +
: Advice and steps to follow when editing the database.
  +
; [[Editing Guideline]]s
  +
: While the style guidelines tell you how entries should look when they are done, the editing guidelines are intended to tell you the best way to get there.
  +
; [[How To Vote]]
  +
: Suggestions and advice about voting on edits.
  +
; [[Misencoding FAQ]]
 
: Deals with data where something went wrong with the [[Character Encodings|character encodings]], and what to do about it.
   
 
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.
==More==
 
   
 
==Changing Guidelines==
* If you have a question regarding an [[Odd Release|OddRelease]] you might want to look for it in [[Additional Metadata|AdditionalMetadata]]. If you find it there your question might already been answered. If you do not find it, you can ask on the [[Mailing List|MailingList]]. 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 [[Information On Editing|InformationOnEditing]] which explains how different edits work etc.
 
* The [[Misencoding FAQ|MisencodingFAQ]] deals with data where something went wrong with the [[Character Encodings|CharacterEncodings]] and what to do about it.
 
   
  +
The style guidelines form a very balanced set of rules, changing them is a slow and careful process.
[[Category:To Be Reviewed]] [[Category:Style]] [[Category:Index]]
 
  +
  +
See [[Proposals|how to propose new guidelines]] for details.
  +
  +
[[Category:Style]]

Latest revision as of 11:50, 26 May 2015

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.


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 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 Standards
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 Guides
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.
How Editing Works
Advice and steps to follow when editing the database.
Editing Guidelines
While the style guidelines tell you how entries should look when they are done, the editing guidelines are intended to tell you the best way to get there.
How To Vote
Suggestions and advice about voting on edits.
Misencoding FAQ
Deals with data where something went wrong with the character encodings, and what to do about it.

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.

Changing Guidelines

The style guidelines form a very balanced set of rules, changing them is a slow and careful process.

See how to propose new guidelines for details.