History:Style Guideline

From MusicBrainz Wiki
Revision as of 21:02, 24 October 2006 by DonRedman (talk | contribs) (SeriesStyleGuideline (Imported from MoinMoin))
Jump to navigationJump to search

Style Guidelines

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 StyleCouncil has agreed on a certain style according to which such text should be entered.

Note that the StylePrinciples of MusicBrainz state:

  1. Follow ArtistIntent.
  2. If 1 is not applicable, use ConsistentOriginalData.
  3. If both 1 and 2 are not applicable, follow the StyleGuidelines.

Principal Guidelines

The following guidelines are available:

  • This is a Wiki version of the OfficialStyleGuidelines on the website which outline how the data in MusicBrainz should be formatted and organized. Being a WikiPage it is more detailed and contains discussion, questions (and answers :-). It is also more up to date than the version on the website.
  • How to capitalize album and track titles. Since June 2004 we are working towards InterNationalization. This will give us language specific standards. CapitalizationStandard lists all available standards for different languages.
  • This is a place for new style guidelines to be proposed and discussed.

Other Guidelines and Help

  • 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 StyleChanges is emerging. See these email threads, HowToChangeStyleGuidelines, and also the older guide on HowToProposeNewGuidelines for details.

The MigrationGuideline requires that major changes to the StyleGuideline be tested by BetaEditing on the TestServer, to figure out if it entails any major SoftStructure changes.