Beginners Guide: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(NeedsIntertwingling + CategoryDocumentation (Imported from MoinMoin))
 
(terminology, small rephrases (Imported from MoinMoin))
Line 1: Line 1:
=Beginner's Guide=
=Beginner's Guide=


<ul><li style="list-style-type:none">[[Image:Attention.png]] '''Status:''' ''This document is still in it's very early stages. It is definitely not ready to be seen by real newcomers. But it is only a question of a little time and work. The idea is to have in one page the essential info a user has to know in order to start doing things correctly in MusicBrainz. Anybody may amend and/or enhance it, but remember, it should be kept small, easy to understand even to people who don't read english fluently. Also this [[Needs Intertwingling|NeedsIntertwingling]].''
<ul><li style="list-style-type:none">[[Image:Attention.png]] '''Status:''' ''This document is still in its very early stages. It is definitely not ready to be seen by real newcomers. But it is only a question of a little time and work. The idea is to have in one page the essential info a user has to know in order to start doing things correctly in MusicBrainz. Anybody may amend and/or enhance it, but remember, it should be kept small, easy to understand even to people who don't read English fluently. Also this [[Needs Intertwingling|NeedsIntertwingling]].''
</ul>
</ul>


Welcome to Musicbrainz! We hope to give you the knowledge you need to start enhancing MB as well as your own files. This document contains many links which we hope will explain [[MusicBrainz]] in more detail and expand on the concept. If this is your first visit here, try to read this in it's entirety before following the purple colored links. [[MusicBrainz]] is a world in itself and you might get lost ;-) Once you begin to understand what is going on, you can start exploring the documentation. [[How To|HowTo]] can be a good procedure-oriented starting point.
Welcome to [[MusicBrainz]]! We hope to give you the knowledge you need to start enhancing MB as well as your own files. This document contains many links which we hope will explain [[MusicBrainz]] in more detail and expand on the concept. If this is your first visit here, try to read all of this page before following any (purple colored) links. [[MusicBrainz]] is a world in itself and you might get lost. ;-) Once you begin to understand what is going on, you can start exploring the documentation. [[How To|HowTo]] can be a good procedure-oriented starting point.


[[MusicBrainz]] (MB in short) is currently made up of three parts: the database, the documentation and software to interact with your files. Of course, you will use the database, this is the whole point of [[MusicBrainz]]! You will consult it, and you will edit it (add or update data). But since editing the database relies on a voting system, you will need the documentation too, in order to understand how to query and update the database. Ultimately, you may want to improve the database to accurately identify and tag your files.
[[MusicBrainz]] (MB in short) is currently made up of three parts: the database, the documentation and software to interact with your files. Of course, you will use the database, this is the whole point of [[MusicBrainz]]! You will consult it, and you will edit it (add or update data). But since editing the database relies on a voting system, you will need the documentation too, in order to understand how to query and update the database. Ultimately, you may want to improve the database to accurately identify and tag your files.
Line 14: Line 14:
==Database==
==Database==


Step 1: In order to update the database, you must register, and then log in. After doing this you are registered and can cross that step from your list.
Step 1: In order to update the database, you must first register and log in. After you are registered, you can cross this step from your list.


Step 2: Subscribe to the artists or groups in which you have a particular interest. This allows you to be notified immediately of changes made to these pages.
Step 2: Subscribe to the artists or groups in which you have a particular interest. This allows you to be notified of changes made to these pages once a day by email.


===Definitions===
===Definitions===


In [[MusicBrainz]] when a user modifies data in any way (see [http://musicbrainz.org/mod_intro.html http://musicbrainz.org/mod_intro.html] and [[How Editing Works|HowEditingWorks]]), this change is called editing, though you may see reference to "moderation", or mods (see [[Moderation Guide|ModerationGuide]], [[Moderation FAQ|ModerationFAQ]], [[Moderation Note|ModerationNote]]) as we reshape our documentation. Most edits must go through a voting process before being applied. (see [[How To Vote|HowToVote]]) Some minor edits (such as changing the case of letters) are applied immediately, no vote being required.
In [[MusicBrainz]] when a user modifies data in any way (see [http://musicbrainz.org/mod_intro.html http://musicbrainz.org/mod_intro.html] and [[How Editing Works|HowEditingWorks]]), this change is called editing, though you may see reference to "moderation", or mods (see [[Moderation Guide|ModerationGuide]], [[Moderation FAQ|ModerationFAQ]], [[Moderation Note|ModerationNote]]) as we reshape our documentation. Most edits must go through a voting process before being applied (see [[How To Vote|HowToVote]]). Some minor edits (such as changing the case of letters) are applied immediately, no vote being required.


The term [[Release]] regroups albums, singles, vinyls, cassettes. A release is made of one or several [[Track]]. If a same cd (same tracklisting) is issued twice, once as a stand-alone, once in a set, it should be entered into the database twice (see [[Release]] and [[Box Set|BoxSet]]).
The term [[Release]] covers albums, singles, vinyls, cassettes, etc. A release is made of one or more [[Track]]s. If a CD with the same tracklisting is issued twice, once as a stand-alone release, once in a set, it should be entered into the database twice (see [[Release]] and [[Box Set|BoxSet]]).


One of the fundamental aims of [[MusicBrainz]] is to offer exact information. To enforce this, we set up Guidelines. These Guidelines allow us to ensure the data input by all users is accurate. These Guidelines vary depending on the kind of album: [[Style Guideline|StyleGuideline]], [[Capitalization Standard|CapitalizationStandard]], [[Classical Style Guide|ClassicalStyleGuide]], [[Soundtrack Style|SoundtrackStyle]], [[How To Make Relationships|HowToMakeRelationships]]
One of the fundamental aims of [[MusicBrainz]] is to offer exact information. To enforce this, we have guidelines. These guidelines allow us to ensure the data input by all users is accurate. These guidelines vary depending on the kind of album, see: [[Style Guideline|StyleGuideline]], [[Capitalization Standard|CapitalizationStandard]], [[Classical Style Guide|ClassicalStyleGuide]], [[Soundtrack Style|SoundtrackStyle]], [[How To Make Relationships|HowToMakeRelationships]]


===Adding an album===
===Adding an album===


Please note, [[MusicBrainz]] strives for accuracy. Factory disc id's are welcomed, if the disc you want to submit is not the factory disc, that's okay, just please don't submit your disc id to the track listing.
Please note, [[MusicBrainz]] strives for accuracy. Factory disc IDs are welcomed, if the disc you want to submit is not the factory disc, that's OK, just please don't submit your disc ID to the track listing.


This is probably one of the first things you will want to do. Either you have a cd, or you don't (vinyl, cassette...)
This is probably one of the first things you will want to do. Either you have a CD, or you don't (vinyl, cassette, ...)
* If you have a cd, first run Picard. Picard analyzes your cd and connects to the [[MusicBrainz]] web site. If the cd exists, please take care to note the tracks. If they are the same you have finished. If they are not the same, you may have a different release. This is a chance for you to enhance MB by adding your more unique disc, please do this rather than try to manipulate the track list that does not fully match your release.
* If you have a CD, first run Picard. Clicking the lookup CD button will make Picard analyze your CD and connect to [[MusicBrainz]]. If the CD exists in [[MusicBrainz]], please check that the track list is the same. If they are the same, you have finished. If they are not the same, you may have a different release. This is a chance for you to enhance MB by adding your more unique CD, please add your CD rather than trying to manipulate a track list that does not fully match your release.


If [[MusicBrainz]] doesn't know your cd, it automatically tries to recover it from freedb. If it finds it, it recovers the freedb data. A word of warning. You must now carefully examine the freedb import since it often needs enhancements to fit into [[MusicBrainz]]'s [[Style Guidelines|StyleGuidelines]]. This is as well why we will often ask for some verification other than free db. If [[MusicBrainz]] really can't offer any useful suggestion for your cd, then you will have to input the tracks manually.
If [[MusicBrainz]] doesn't know your cd, it automatically tries to recover it from freedb. If it finds it, it recovers the freedb data. A word of warning. You must now carefully examine the freedb import since it often needs enhancements to fit into [[MusicBrainz]]'s [[Style Guidelines|StyleGuidelines]]. This is as well why we will often ask for some verification other than free db. If [[MusicBrainz]] really can't offer any useful suggestion for your cd, then you will have to input the tracks manually.
* If you don't have a cd, then first do a search, usually using the title of the album. If what you find is reasonably different from what [[MusicBrainz]] may already have, then you have a new release, you should enter it manually.
* If you don't have a CD handy, you will need to search by hand. Usually the best way is to search for the title of the release. If you can't find the release you have, or the only matches in [[MusicBrainz]] are reasonably different from yours, then you have a new release and you should enter it manually.
* It helps immensely if you can provide a link to Amazon or another service with the release to help us populate the fields of the release, double check track accuracy and times. While welcoming bootlegs, we try and discourage a home made various mix. Our aim is toward widely reaching and readily useable accurate information. Thus your local factory made Various Artist may not be accepted for it's very slim range of user need.
* It helps immensely if you can provide a link to a page containing more information on the release. Official websites and comprehensive fan sites are good, as are online shops, such as Amazon. These links not only helps other editors double check accuracy, but helps us find any extra information which can be added. While welcoming bootlegs, we try and discourage a home made various mix. Our aim is toward widely reaching and readily useable accurate information. Thus your local factory made various artist disc may not be accepted for its very slim range of user need.


===Order of operations when editing an object with a pending edit===
===Order of operations when editing an object with a pending edit===
Line 43: Line 43:
===Advanced editing===
===Advanced editing===


One of the most fundamental database tools of [[MusicBrainz]] is [[Advanced Relationship|AdvancedRelationship]]s. Under this name, we regroup "links" from one object to another. We use ARs to say who composed an album or a track, who performed in an album or a track, who was a member of group so-and-so, which track is an original version of this track... ARs are slower and more complex to enter than albums and tracks, but it is these entries which what allow [[MusicBrainz]] to be a full-fledged database rather than a simple collection of albums and tracks!
One of the most fundamental database tools of [[MusicBrainz]] is [[Advanced Relationship|AdvancedRelationship]]s. These allow us to link from one object to another. We use ARs to say who composed a release or track, who performed on a release or track, who was a member of a specific group, which track is the original version of the track, and so on. These ARs are slower and more complex to enter than releases and tracks, but it is these entries which what allow [[MusicBrainz]] to be a full-fledged database rather than a simple collection of releases and tracks!


album-level ARs should be added only when they impact on all the tracks on the album.
Release-level ARs should only be added when they apply to all the tracks on the release.


Thank you for taking the time to read and learn more about what makes [[MusicBrainz]] thrive. Your next visit should be to [[Code Of Conduct|CodeOfConduct]] or the [[How To|HowTo]].
Thank you for taking the time to read and learn more about what makes [[MusicBrainz]] thrive. Your next visit should be to the [[Code Of Conduct|CodeOfConduct]] or the [[How To|HowTo]].


[[Category:To Be Reviewed]] [[Category:Documentation]]
[[Category:To Be Reviewed]] [[Category:Documentation]]

Revision as of 23:56, 29 May 2006

Beginner's Guide

  • Attention.png Status: This document is still in its very early stages. It is definitely not ready to be seen by real newcomers. But it is only a question of a little time and work. The idea is to have in one page the essential info a user has to know in order to start doing things correctly in MusicBrainz. Anybody may amend and/or enhance it, but remember, it should be kept small, easy to understand even to people who don't read English fluently. Also this NeedsIntertwingling.

Welcome to MusicBrainz! We hope to give you the knowledge you need to start enhancing MB as well as your own files. This document contains many links which we hope will explain MusicBrainz in more detail and expand on the concept. If this is your first visit here, try to read all of this page before following any (purple colored) links. MusicBrainz is a world in itself and you might get lost. ;-) Once you begin to understand what is going on, you can start exploring the documentation. HowTo can be a good procedure-oriented starting point.

MusicBrainz (MB in short) is currently made up of three parts: the database, the documentation and software to interact with your files. Of course, you will use the database, this is the whole point of MusicBrainz! You will consult it, and you will edit it (add or update data). But since editing the database relies on a voting system, you will need the documentation too, in order to understand how to query and update the database. Ultimately, you may want to improve the database to accurately identify and tag your files.

Documentation

The documentation is WikiDocs. These are the "how to" of the database and will be referred to often within the notes left during the voting process. Usually in the term of Style, or StyleGuide.

Database

Step 1: In order to update the database, you must first register and log in. After you are registered, you can cross this step from your list.

Step 2: Subscribe to the artists or groups in which you have a particular interest. This allows you to be notified of changes made to these pages once a day by email.

Definitions

In MusicBrainz when a user modifies data in any way (see http://musicbrainz.org/mod_intro.html and HowEditingWorks), this change is called editing, though you may see reference to "moderation", or mods (see ModerationGuide, ModerationFAQ, ModerationNote) as we reshape our documentation. Most edits must go through a voting process before being applied (see HowToVote). Some minor edits (such as changing the case of letters) are applied immediately, no vote being required.

The term Release covers albums, singles, vinyls, cassettes, etc. A release is made of one or more Tracks. If a CD with the same tracklisting is issued twice, once as a stand-alone release, once in a set, it should be entered into the database twice (see Release and BoxSet).

One of the fundamental aims of MusicBrainz is to offer exact information. To enforce this, we have guidelines. These guidelines allow us to ensure the data input by all users is accurate. These guidelines vary depending on the kind of album, see: StyleGuideline, CapitalizationStandard, ClassicalStyleGuide, SoundtrackStyle, HowToMakeRelationships

Adding an album

Please note, MusicBrainz strives for accuracy. Factory disc IDs are welcomed, if the disc you want to submit is not the factory disc, that's OK, just please don't submit your disc ID to the track listing.

This is probably one of the first things you will want to do. Either you have a CD, or you don't (vinyl, cassette, ...)

  • If you have a CD, first run Picard. Clicking the lookup CD button will make Picard analyze your CD and connect to MusicBrainz. If the CD exists in MusicBrainz, please check that the track list is the same. If they are the same, you have finished. If they are not the same, you may have a different release. This is a chance for you to enhance MB by adding your more unique CD, please add your CD rather than trying to manipulate a track list that does not fully match your release.

If MusicBrainz doesn't know your cd, it automatically tries to recover it from freedb. If it finds it, it recovers the freedb data. A word of warning. You must now carefully examine the freedb import since it often needs enhancements to fit into MusicBrainz's StyleGuidelines. This is as well why we will often ask for some verification other than free db. If MusicBrainz really can't offer any useful suggestion for your cd, then you will have to input the tracks manually.

  • If you don't have a CD handy, you will need to search by hand. Usually the best way is to search for the title of the release. If you can't find the release you have, or the only matches in MusicBrainz are reasonably different from yours, then you have a new release and you should enter it manually.
  • It helps immensely if you can provide a link to a page containing more information on the release. Official websites and comprehensive fan sites are good, as are online shops, such as Amazon. These links not only helps other editors double check accuracy, but helps us find any extra information which can be added. While welcoming bootlegs, we try and discourage a home made various mix. Our aim is toward widely reaching and readily useable accurate information. Thus your local factory made various artist disc may not be accepted for its very slim range of user need.

Order of operations when editing an object with a pending edit

Take care when altering the database in reference to previous edits. If there is a pending edit (usually highlighted in yellow), one edit will cancel another out. You will want to delete your edits if you notice your own mistake, rather than edit over a previous edit.

Advanced editing

One of the most fundamental database tools of MusicBrainz is AdvancedRelationships. These allow us to link from one object to another. We use ARs to say who composed a release or track, who performed on a release or track, who was a member of a specific group, which track is the original version of the track, and so on. These ARs are slower and more complex to enter than releases and tracks, but it is these entries which what allow MusicBrainz to be a full-fledged database rather than a simple collection of releases and tracks!

Release-level ARs should only be added when they apply to all the tracks on the release.

Thank you for taking the time to read and learn more about what makes MusicBrainz thrive. Your next visit should be to the CodeOfConduct or the HowTo.