How to Write Edit Notes: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(Deleting a duplicate would be bad practice, so: s/deleting/merging/)
m (abstainers get mail too)
 
(16 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Whenever you make an [[How Editing Works| edit]] on Musicbrainz, you will be asked to add an [[Edit Note|EditNote]]. This is usually just before you press the "Apply" button. Most edits need to be [[How Voting Works| voted]] on by other MusicBrainz users, to catch errors and bad data. The edit notes are there to help the voters determine if an edit is correct.
Whenever you [[How Editing Works|edit]] MusicBrainz data, you will be asked to add an [[Edit Note|edit note]]. Most edits need to be [[Introduction to Voting|voted on]] by other MusicBrainz users, to catch errors and bad data. Edit notes are there to help the voters determine if an edit is correct.


If a voter disagrees they will usually add another edit note, describing the issue or asking for proof or clarification. If they don't, you can ask them in an edit note. Each edit note is sent by email to the original editor and everyone who voted on an edit. (This is why you should add your email when making an account on [[MusicBrainz]].)
If a voter disagrees with an edit or needs more information they should add a note asking for clarification (see [[#How to add edit notes when voting on and reviewing edits|below]]).


By default, each edit note is sent by email to the original editor, everyone who commented on an edit, and everyone who voted on an edit.
There are two parts to this how-to: the first is for the edit notes you should add when making an edit, and the second is for adding further notes to discuss an edit, when necessary (i.e. when voting or answering a voter).


When writing any edit note, please keep the '''[[Code of Conduct]]''' in mind.
==How to add edit notes when changing data==


==How to add edit notes when editing data==
As described above, the primary reason for adding an edit note is to help voters to decide if the edit is correct. It is almost always optional to add an edit note, but you are strongly encouraged to add one for all but the most trivial and obvious edits. (There is another reason to add a note with "proof": in the future, someone may spot a possible error or might need to check something; it's easier if they can look at the history of edits—like [http://musicbrainz.org/mod/search/results.html?object_type=album&orderby=desc&object_id=36978 this one]—and see the proof.)


The primary reason for edit notes is to help voters (and subsequent editors) to decide if an edit is correct. It is (almost always) optional to add an edit note, but you are '''strongly encouraged''' to add one. Edit notes can also be useful later, when data is subsequently edited and past sources need to be consulted.
First in the edit note you should explain the edit, if necessary. ''Don't'' just add a note that says '''added new album''' or '''changed release date'''; this is immediately obvious to the voters. However, when merging a release (for example) say if it's because it's a duplicate (and link to the pair) or if you don't think it really exists (and explain why) or if it doesn't belong in [[MusicBrainz]] for some reason. Try to think what you'd need if you tried to vote on such an edit for an edit on an artist or album you're not familiar with.


===What should be included?===
Second—and more importantly—add some kind of proof for the edit. Remember that most edits need to be voted on, and three unanimous Yes votes are needed to apply the edit immediately. This means that three different people need to check an edit; it is much more efficient if the original editor adds information to help them. Also, usually the editor is more familiar with the subject (because they have the CD, or they searched on the net in order to check their edit).
# A URL with some sort of proof your edit is reasonable and correct.
# A link to relevant MusicBrainz [[Style Guideline]]s
# What you're doing and why you're doing it, unless it's ''outstandingly'' obvious (when adding a new release, for example, it's not useful to just write "I'm adding a release")


===What constitutes good proof?===
The best kind of proof to put in edit notes are links to where you found the information in the first place. If you find the information on the Internet, this means links to the web sites you use. If you add information from a CD you own, you should say this, but it's a very good idea to also search for the same kind of websites to give as proof. (Also, don't forget to [[How To Add Disc IDs|add a discid]] when adding a new release you own on CD!)
* discographies: There are some sites with good (i.e. accurate) discographies; [http://www.discogs.com/ discogs] is often a good choice for many kinds of music, and [http://www.metal-archives.com/ Encyclopaedia Metallum] is a good site for metal. Often you may find a fan-site dedicated to a certain artist, for example [http://unit.bjork.com/77island/ 77ísland] is a site dedicated to [http://musicbrainz.org/artist/87c5dedd-371d-4a53-9f7f-80522fb7f3cb.html Björk]'s discography. Whether such sites have the artist's support or not, they are often detailed and quite accurate. You can find many such sites using a [http://www.google.com good search engine] and searching for "ARTIST_NAME discography"; some deal with only original recordings, some try to exhaustively list bootlegs, compilations, and biographical info. Many popular artists have such links on their artist page in [[MusicBrainz]], that's a good place to start.
* official sites: Naturally, you will often find such information on an artist's home-page or the record label's home page. These have the advantage of being official, but see below for a discussion of accuracy and trustworthiness. Also, not all artists have very detailed info on their sites;
* virtual music shops: Often shops like [http://www.amazon.com/ Amazon] and the [http://www.apple.com/itunes/store/ iTunes] store can be used to find a record. These are generally good ways to prove that a release exists, but such sites are often inaccurate about detailed information, including track lists and release dates. Be wary that iTunes can only be accessed by users with the iTunes software, thus it's a bad kind of link.
* cover images: Often a good way to find/prove info about a record is to look at its cover. Even if you use your CD's cover to do this, the voters usually don't have it. You can find scans of the cover on several specialized sites, like [http://www.cdcovers.to/ this one]. If you don't find the cover then, you can scan yours and add it. For proof purposes, you can also just take a close-up photo with a digital camera (use "macro" mode), put it on any free hosting site and link to it in the edit note.


One or (if possible) more of the following, in approximate order of preference:
When adding a release using information from the cover, please always add the label and catalogue number (it's always somewhere on the cover). It's best to [[Release Event|add it in the release event]], but if you don't want to, at least put them in the edit note. If you add a release that you can't find on the Internet at all (can happen for some old or obscure things) and for some reason can't take a photo of it (it's not very convenient, we know), this information can help a lot. (But more is always better, because we can check for errors and make the submissions more accurate!)


# Scans of liner materials
Adapt the kind of proof you give according the edit type. If you fix capitalization for a non-English language, often it's enough to just link the relevant guideline. If you fix a spelling error, you may not need to add anything. (However, if you think the correct title has some unusual spelling, even the cover scan may not be enough, because [[Artist Intent|it may be wrong]].) If you are adding a release date the cover may not help, but usually a few e-shop/artist/label links are enough (not just one though: some are often wrong, e-shops in particular.) Above all, don't add a note that just says "adding release date", that's just obvious and isn't helping at all. Say where you got it from, at least.
# Official sites for the artist/label
# Other sites ''with a review process'', such as [http://www.discogs.com/ Discogs], [http://wikipedia.org Wikipedia], or [http://www.metal-archives.com/ Encyclopaedia Metallum]
# Reputable online shops like [http://www.amazon.com/ Amazon] and [https://www.apple.com/itunes iTunes]


Note that online stores are often good proof of the ''existence'' of a release, but often have incorrect information ''about'' the release. These should be paired with other proof whenever possible. <!-- todo: link to page of good vs. bad sources -->
==How to add edits notes when voting and answering==


===What doesn't constitute good proof?===
Anyone can add an edit note to an already entered edit. This includes already applied and not-yet-applied edits. Such notes are sent by mail to everyone that participated, including the original editor, voters that didn't abstain, and anyone else who added a note to that edit.
* [[FreeDB]]
* Other user-editable sites that ''lack a review process''
* Links to Google and similar searches


==How to add edit notes when voting on and reviewing edits==
You can add an edit note to ask for clarification, for example if you don't understand the edit or you think something may be wrong. You should ''always'' add an edit if you vote No on an edit, explaining why you don't agree. Of course, when someone adds such an edit note on your edits you should answer with explanations and, if it's the case, proof.


Anyone can add an edit note to an already entered edit. This includes already applied and not-yet-applied edits.
Please try to be calm and courteous when discussing an edit, and try to be brief and (most importantly) as clear as possible. Always remember than it is very easy to seem harsh or impolite when using such messages. If you write a note (especially when contesting an edit) try to be very polite and friendly, and use smileys to soften the criticism. If you receive a negative note, don't become angry, and avoid arguing. Give proof, link to the guidelines you think support your position, and ''always'' be ready to accept your own mistakes. If you're not sure of something, you can always ask on [http://musicbrainz.org/doc/UsersMailingList the user's mailing list] or on [http://forums.musicbrainz.org/ the forums]. Many users are not native English speakers: be patient and understanding, write as clearly as you can. Apologize if you misunderstood something. And if by any chance you do encounter an asshole, that's no reason to participate in a flame-war.


===When should I leave an edit note when I am not the original editor?===
Remember that all members are here trying to gather accurate data. [[MusicBrainz]] is many things to many people: some see it as a discographic catalogue, some as a file-tagging database. Be open to other points of view. It's not the end of the world if you need something a little different: you can always change file tags manually, for example. Also, remember what guidelines are: they were carefully chosen with many users in mind, so read them, understand and use them, but they're not the Word of God either. Sometimes there are exceptions, and users may need to make some decisions themselves. Use edit notes for this.


# If you vote No on an edit
Another ''very important'' point is that the users that vote are often more experienced (i.e. were here for a long time), and that new users are often likely to make mistakes (e.g. not add proofs). A consequence is that voters often add very terse notes like "proof?" or "No, X is wrong", and new users tend to feel offended in such cases. Remember that the voters can't know if you are a very knowledgeable fan of the band, and they're not challenging you in person. Often they vote on large number of edits (remember, three votes are necessary for each edit), so they often don't have time for lots of explanations. Editors, try to understand what the problem is, read the relevant guidelines, ask for explanations (politely!) and the issue will be solved. Voters, try to be gentle, and link to this page if you spot a new user that isn't adding proof. Mistaken edits [[How To Cancel Edits|can be canceled]] (and reentered if necessary), or they may be applied and fixed afterward; it isn't necessary to cancel a whole "add album" edit only to fix a release date or some spelling.
# If you need clarification or better proof in order to vote
# If there is an ongoing discussion in a given edit's notes ''to which you can contribute''


===What should I include in such an edit note?===
==Other details==


# Say what you need, or why you voted No.
No source is absolutely accurate. All may contain errors, including discographies, official sites, on-line shops and [[Artist Intent Vs Facts|the album's cover]]. [[MusicBrainz]] strives toward an [[Artist Intent|ideal standard of accuracy]]; it is not perhaps reachable, but we try to get as close as possible. This means that in some cases a single source is not enough as proof. It is recommended whenever there is any doubt about some information (the exact track list, the spelling of a song's title, the release date of an album) that you check several sources, and try to get as close as possible to accurate information. There is no single, simple set of rules to do this; this is why we need users to spot and fix errors, instead of just using a program to dump all the data it can find in the database. This also means that some people will reach different conclusions in unusual situations. Try to explain your reasoning, show your information ("proof"), '''listen''' to others, and try to reach a consensus. Even if that's impossible, don't start a flame war. It's not the end of the world.
# Include links to MusicBrainz [[Style Guideline]]s or URLs with proof, if these are relevant
# Be concise, but also complete. Especially terse edit notes are intimidating to new editors and unuseful to new voters; especially long ones may not be read.


===How should I respond to these edit notes, if I am the original editor?===
Another thing: there is a partial consensus on [[MusicBrainz]] that incomplete data is better than wrong data. Rather than add detailed information "based on a hunch", without being able to find reasonable proof, add only what you can justify. It is usually possible to fill data fields partially. For instance, a release date has a year-month-day date and a release country; you can add only the year if you're not sure about the exact release date (Amazon is often wrong about these, for example), and use "unknown country" rather than "worldwide" unless you're quite sure about it (and can show several good sources!).

[[Category:To Be Reviewed]] [[Category:How To]] [[Category:Editing]]
# Provide clarification or better proof, if requested
# Explain further why the editor should vote Yes or abstain, if your edit received a No vote
# If you agree with the concerns of the other editor, cancel your edit and explain this in the edit note when you cancel

{{HowtoBox}}

[[Category:WikiDocs Page]]

Latest revision as of 09:18, 26 January 2019

Whenever you edit MusicBrainz data, you will be asked to add an edit note. Most edits need to be voted on by other MusicBrainz users, to catch errors and bad data. Edit notes are there to help the voters determine if an edit is correct.

If a voter disagrees with an edit or needs more information they should add a note asking for clarification (see below).

By default, each edit note is sent by email to the original editor, everyone who commented on an edit, and everyone who voted on an edit.

When writing any edit note, please keep the Code of Conduct in mind.

How to add edit notes when editing data

The primary reason for edit notes is to help voters (and subsequent editors) to decide if an edit is correct. It is (almost always) optional to add an edit note, but you are strongly encouraged to add one. Edit notes can also be useful later, when data is subsequently edited and past sources need to be consulted.

What should be included?

  1. A URL with some sort of proof your edit is reasonable and correct.
  2. A link to relevant MusicBrainz Style Guidelines
  3. What you're doing and why you're doing it, unless it's outstandingly obvious (when adding a new release, for example, it's not useful to just write "I'm adding a release")

What constitutes good proof?

One or (if possible) more of the following, in approximate order of preference:

  1. Scans of liner materials
  2. Official sites for the artist/label
  3. Other sites with a review process, such as Discogs, Wikipedia, or Encyclopaedia Metallum
  4. Reputable online shops like Amazon and iTunes

Note that online stores are often good proof of the existence of a release, but often have incorrect information about the release. These should be paired with other proof whenever possible.

What doesn't constitute good proof?

  • FreeDB
  • Other user-editable sites that lack a review process
  • Links to Google and similar searches

How to add edit notes when voting on and reviewing edits

Anyone can add an edit note to an already entered edit. This includes already applied and not-yet-applied edits.

When should I leave an edit note when I am not the original editor?

  1. If you vote No on an edit
  2. If you need clarification or better proof in order to vote
  3. If there is an ongoing discussion in a given edit's notes to which you can contribute

What should I include in such an edit note?

  1. Say what you need, or why you voted No.
  2. Include links to MusicBrainz Style Guidelines or URLs with proof, if these are relevant
  3. Be concise, but also complete. Especially terse edit notes are intimidating to new editors and unuseful to new voters; especially long ones may not be read.

How should I respond to these edit notes, if I am the original editor?

  1. Provide clarification or better proof, if requested
  2. Explain further why the editor should vote Yes or abstain, if your edit received a No vote
  3. If you agree with the concerns of the other editor, cancel your edit and explain this in the edit note when you cancel
How-To Pages
Introductory Guides
Basic How-Tos
Specific How-Tos