The Add Alias dialogue, reached with a URL like
/add-alias, has a link to a documentation page, https://musicbrainz.org/doc/Aliases . However, that documentation doesn’t really explain to me how to use the Add Alias dialogue.
In particular, the dialogue has an Alias Type menu, with entries “Artist/Release/Work Name”, “Legal Name” (for Artists only), and “Search Hint”. Nothing in the documentation explains these entries, or which one to choose.
I suggest rewriting the introduction paragraph to read as follows:
Aliases are variant names that supplement the main name of the entity for a variety of purposes.
- In a search, if an entity’s alias matches a search term (even if the entity’s actual name does not), the entity will be given as a result.
- Aliases are used for localization of a the entity’s main name into a different language, especially into a different script (e.g. the Russian name like Чайковский, has an English alternate “Tchaikovsky”, and a German alternate “Tschaikowski”).
- The change over time of an entity’s name can be documented by Aliases (e.g. Carnegie Hall was known as “Music Hall” from 1891–1893).
- The legal name of an Artist who normally performs under a stage name can be documented by an Alias, among other methods (e.g. Lady Gaga’s legal name is Stefani Joanne Angelina Germanotta).
Aliases can have one of up to four Types.
- “(Entity) Name” alias type, i.e. “Artist Name” for Artists, “Work Name” for Works: used for localization, to provide an alternate version of a name for a specific language. Also used for describing the change to an entity’s name over time.
- “Search Hint” alias type: used this for an Alias when giving an alternate spelling, or common mis-spelling, that users may search for.
- “Legal Name” alias type (available for Artist aliases only): used for an Alias which gives the legal name of an Artist, where the entity name is their stage name.
- Unspecified type: for many existing Aliases, there is no type specified. Many of these entries predate the addition of the Alias Type field, and are Search Hint or (Entity) Name type Aliases.
For all Alias Types except “Search Hint”, you can specify the specific language, and/or start and end date, for which the Alias applies. You can also supply a sort name, which is used in place of the Alias’s primary name when sorting. When you set Alias Type to Search Hint, these extra fields are disabled.
I suggest changing the link text in Guidelines to be a bit more clear:
Please see the Style guidelines for Aliases.
I suggest breaking the section When to use aliases into three:
When to use Search Hint type Aliases
Include items 1–9 of the existing content.
When to use (Entity) Name type Aliases
Include items 10-12 of the existing content.
Add new item:
- Name changes over time: When the official name of an entity was different in the past than it is now. e.g. Carnegie Hall was known as “Music Hall” from 1891–1893
When to use Legal Name type Aliases
Include item 13 of the existing content.
Comments? If the response here is positive, I can make an edit to https://wiki.musicbrainz.org/Aliases and let the Documentation reviewers consider it.