[OLD] Style Guide & Common Terms

[regalius]

UPDATE: 👉 Please Check out the Glossary and TRANSLATION.md file

Hi @reactjs/reactjs-org-indonesian-translation ,

Before more contributors joined, I think we need to:

1. Start building our style guide
2. Agreed upon common diction/terms that we'll choose

Perhaps, we need a TRANSLATION.md like our Japanese counterpart.

[gedeagas]

Checkout the glossary

Common Terms

Propose new terms here:

English	Indonesian

If you encounter a term that is not yet in the list, please suggest it here. If you also come up with the translation that would be awesome.

[regalius]

I propose the following diction:

re-render --> render ulang

This terms can be either kept in English or translated to Bahasa (me personally prefer them to be in english since it is easier to understand):
controlled component --> Komponen terkontrol
uncontrolled component --> Komponen tak terkontrol

The other terms I think would be easier for readers if it stays in English because it'll be a little bit weird if it translated into standardized Bahasa:
arrow function --> ??
event handler --> pengurus even ?

[gedeagas]

i agree with you @regalius, sometimes literal translation can be little bit weird if it translated into standardized Bahasa. so for those word i think we should keep it as is.

controlled component --> Komponen terkontrol
uncontrolled component --> Komponen tak terkontrol

for these word, i also prefer them in english.
But, if we want to make translation for people who doesn't speak english that well would they understand the meaning of these word ?.

@arfianadam do you have other opinion ?

[arfianadam]

The point of having a localized documentation is to have more people understand the contents better. Indeed there are a lot of terms that were already familiar and easier to understand in English. But, we can't throw away the fact that there might be still many people who don't understand those terms.

So the solution would be, if the literal translations of those terms sound weird or even harder to understand, first we must try to think if there is better words to replace the literal translations. Then if we can't find the replacement, we may use the English word instead. Note that we can't just put English words here just because it's hard to translate them.

Since it's undeniable that there will be not translated English words, we can come up with a separate Glossary page that explains those might-be-hard-to-understand terms. Can we do that @tesseralis ?

[tesseralis]

@arfianadam There's already a glossary in the docs: https://reactjs.org/docs/glossary.html It might be a good idea to do that first :)

One thing I've seen people do is use the english term but put the translated term in parentheses the first time it's mentioned.

[arfianadam]

Let's track the progress of those terms' translation here. Later when we are ready to publish it we should update https://github.com/reactjs/id.reactjs.org/blob/master/CONTRIBUTING.md so that contributors can know the decision. I've edited @gedeagas 's comment to track the progress.

[regalius]

Several things that I noticed after translating the Homepage,

About Component/Komponen stuff. I think it makes more sense to keep it as it is for:

• controlled component
• uncontrolled component
• stateful component
• stateless component

But for standalone Component we can just translate it to Komponen, later we can have some kind of glossary that explains it in Bahasa just like 訳語の統一 in Japanese Translation repo.

The other thing that I noticed is about our style guide on when we should italicize a foreign terms? I think we should italicize them when it is part of a paragraph only (not in the header)

[gedeagas]

@regalius in my opinion, loanwords only need to be italicized when it is part of a paragraph only.

[martinock]

Hi, should we translate "Function Component" into "Komponen Fungsi" or just let it be "Function Component"?

PS*: Also asking for "Class Component"

[regalius]

In my opinion, for now, I think let's keep them in English @martinock, because I found them to be very tightly coupled to React-specific term, so it'll be weird if it got translated to standardized Bahasa, later if we find the needs to translate the whole * Component, we can do it easier.

[regalius]

I've added @gedeagas 's comment to the glossary, feel free to improve it!

[mendoanjoe]

try using this ? I.G.3. @martinock