Naming Conventions
These naming conventions are suggested practices to keep things readable and somewhat consistent.
RTL is hard
Mixing Right-to-left and Left-to-Right text is hard. It is more than just putting things on right alignment, it also has to do with the order that characters are entered and where spaces occur.
When to use what characters for Hebrew
It is most readable and predictable to limit the special characters to a dash - or a plus +.
Avoid using ( and ) as they can interfere with RTL reading order.
| Version | Name |
|---|---|
| Song | שיר |
| Song - Short | שיר - ק |
| Song (New) | שיר - חדש |
| Song (New) - Short | שיר - חדש - ק |
To accomplish this you always want a space after a name, followed by a dash, another space, then a descriptor. That is:
<space><dash><space><Descriptor>
What about artist names
It is preferable, when searching, to read the name in the order you would say it. Said differently, that is "first name" followed by "last name".
<artist-firstname><space><artist-lastname>
What about two artists
There are at least two cases. When you have two names for unrelated artist contributors, put:
<artist1><space><plus><space><artist2>
When you are looking at a couple that is contributing together you could use:
<artist1-firstname><space><ampersand><artist2-firstname><space><shared-lastname>
| Display Names |
|---|
| Orna Datz |
| Moshe Datz |
| Orna Datz + Moshe Datz |
| Orna & Moshe Datz |
When to use what characters for English
When dealing with a dance name, adding a "Short" descriptor, adding a dash makes a consistent transition.
If you have another descriptor, add it inside parenthesis.
The result is an easy to read, consistent output in search results.
| Name | Version |
|---|---|
| Something | Original song |
| Something (New) | New music |
| Something - Short | Cut version |
| Something - Short (New) | Cut version, new music |
The recommendation for short versions is:
<name><space><dash><space><Descriptor>
For other descriptors, use:
<name><space><open-parenthesis><Descriptor><close-parenthesis>