Style Guide

[itayyehezkel]

Hey guys,

I think we should stay synchronized by adding a style guide as @tesseralis mentioned in her issue. So I made a few translations which makes sense for me, but feel free to suggest something else. After we all agree about the common language I'll create TRANSLATION.md file.

Style Guide

Original	Translation
application	אפליקציה
array	מערך
attribute	מאפיין
bind	bind
callback	callback
class	מחלקה
cleanup	נקיון\לנקות
component	קומפוננטה
context	context
constructor	בנאי
DOM	DOM
element	אלמנט
encapsulated	מכומס
export	ייצוא
feature	תכונה
function	פונקציה
Hook	Hook
HTTP header	HTTP header
import	ייבוא
key	מפתח
library	ספרייה
lifecycle	מחזור חיים
markup	markup
method	מתודה
module	מודול
mount	mount
node	צומת
object	אובייקט
production	production
props	props
React	React
reconciliation	reconciliation
ref	ref
render	רנדר\לרנדר
repository	ריפוזיטורי
section	חלק
state	state
string	מחרוזת
TLDR	אמ;לק
UI	ממשק משתמש
user interface	ממשק משתמש

[galnir]

Yeah it's a great idea
Btw all the translations we pushed so far refer to 'component' as קומפוננטה and 'React' as ריאקט

[galtalmor]

Good initiative!
Some thoughts:

1. Should we actually translate React to ריאקט or leave it in English? I think leaving it in English is more appropriate.
2. Also, I just stumbled upon @yarons' suggestion to translate repository to מאגר, which I disagree with, thinking a clearer translation would be ריפוזיטורי.
3. Shouldn't we translate UI to ממשק משתמש as well, I think we should?
4. Why not translate key to מפתח? In my opinion, when there's a good Hebrew translation for a word it should be translated, in order to help those with weaker English, except if it is a core keyword in React like state for example.
5. Why not translate cleanup to נקיון/לנקות? Same as above.
6. Why not translate lifecycle to מחזור חיים? Same as above.
7. Lastly, we need to decide in which noun we use, should we translate "you" as את\ה or אתם? I vote for אתם.
8. I would add to the list: section -> חלק, render -> לרנדר, encapsulated -> מכומס\ת, method -> מתודה, DOM node -> צומת DOM?, application -> אפליקצייה, mounting -> mounting?, constructor -> בנאי

What do you guys think of these issues?

[itayyehezkel]

Thanks @galtalmor I tend to agree with you, I think that we should listen to our readers, most of Israeli FED industry using English terms and we should not translate every term to Hebrew. And את\ה sounds to me more personal, but I would like to see what others think about it.

[yarons]

There are solutions to avoid את/ה/ם, it requires making the text less personal and more generalized so it will approach to women as well.

[galtalmor]

@yarons I don't think avoidance is a good solution, it will require the translation to be different from the original, make it harder to translate and as you said will be less personal. I think that choosing either אתה or אתם will be the best solution, we just need to choose one and stick with it. IMO אתם is the better option since it is kind of directed to both sexes, while אתה isn't, but that's only my opinion.

[yarons]

@galtalmor
The translations of Firefox, Wikipedia, Ubuntu, VLC, Mac OS X etc. are all using these rules so it's pretty common to avoid gender (Facebook for example is using dynamic gender customization system so the messages are gender related and usually does not require any additional conjugation).

אתה is the default gender in Hebrew, applies also to women but it's less natural to them so I tend to avoid it.
אתם just doesn't sound right and pretty claustrophobic (who else is with me?).

Do as you wish, I'm just sharing some insights from my personal history, I can only recommend.

[galnir]

@yarons I agree with @galtalmor, if we want to avoid את/ה the only option is אתם(which I used in 'thinking in react' translation)

[yarons]

@galnir
As you wish, as I was saying, most well-known open source solutions are translated without gender bias, there's absolutely no reason to use plural form.

[itayyehezkel]

What do you think about check with other groups to see how they solved it? maybe all languages with grammatical genders should do the same.

[yarons]

@itayyehezkel It's more relevant when you ask yourself whether to translate, transliterate or keep the term as it is, it's less relevant to gender issues, French and Russian for example has a third gender (neutral) so they don't have this problem, In Arabic it's pretty common to use the masculine form (Even love songs that are targeted at women, sang be men, are in masculine form).

Cultural diversity does not really allow having all these comparisons since they don't make any sense.

[galtalmor]

Okay lets do it this way (please only vote once):

[dormd]

production - production

[dormd]

What do you think?
Attribute - תכונה
HTTP header - HTTP header