You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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 ?
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.
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 ?.
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 ?
Reacted by Andre Pratama, Felix Tan, Aisy Rozsidhy, Sastra Nababan, Riandy Dimas, Irfan Maulana, Harry Ermawan and Doni Wirawan
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.
Reacted by Felix Tan, Agastya Darma, Kevin Anantha, budiharta, Arfian Adam, Resi Respati, Farizal Tri Anugrah, Sastra Nababan, Shahul Hameed and Doni Wirawan
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)
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.
@spondbob I agree with using versi pengembangan and versi produksi for those terms. Let's go with that!
I'm also adding one more suggestion after reading through the RSNI:
English
Indonesian
node
simpul, node
tree
diagram, bagan
We currently have these translated to "pohon" in some pages, but since "tree" in many of these contexts refers to the diagram of things (i.e. DOM tree), we might as well standardise these terms as such.
Hi, I want to ask what's the proper translation for feature flags ? Is it bendera fitur or flag fitur
Also, can we strive for consistency for words like project -> proyek object -> obyek
since there's still some translated pages that uses objek and projek.
I also found some typo in pages. If it's alright can I make a different PR to fix them?
The section on Hooks sees some similar paragraphs describing Hooks, but various contributors have their own version of translation. Here are PR diffs related to Hooks:
- *Hooks* are a new addition in React 16.8. They let you use state and other React features without writing a class.+ *Hooks* merupakan fitur baru di React 16.8. Fitur ini memungkinkan Anda menggunakan *state* dan fitur React lainnya tanpa menuliskan sebuah kelas.
- *Hooks* are a new addition in React 16.8. They let you use state and other React features without writing a class.+ *Hooks* adalah tambahan baru di React 16.8. *Hooks* memungkinkan Anda dapat menggunakan *state* dan fitur lain di *React* tanpa menulis *class*.
- *Hooks* are a new addition in React 16.8. They let you use state and other React features without writing a class.+ *Hooks* merupakan penambahan baru pada React 16.8. *Hooks* memungkinkan Anda menggunakan *state* dan fitur React lainnya tanpa membuat sebuah kelas.
- *Hooks* are a new addition in React 16.8. They let you use state and other React features without writing a class.+ *Hooks* merupakan fitur baru di React 16.8. Fitur ini memungkinkan Anda menggunakan *state* dan fitur React lainnya tanpa menuliskan sebuah kelas.
To make these consistent, I propose we change them all to this:
*Hooks* merupakan fitur baru pada React 16.8. *Hooks* memungkinkan Anda menggunakan *state* dan fitur React lainnya tanpa membuat sebuah kelas.
how we translate higher-order components in bahasa? should it be translated or leave it as is?
@spondbob I agree with using versi pengembangan and versi produksi for those terms. Let's go with that!
I'm also adding one more suggestion after reading through the RSNI:
English Indonesian
node simpul, node
tree diagram, bagan
We currently have these translated to "pohon" in some pages, but since "tree" in many of these contexts refers to the diagram of things (i.e. DOM tree), we might as well standardise these terms as such.
Call me old school, but I don't think we can translate DOM tree as "diagram DOM". It should stay as "pohon DOM", with its "root", induk, and anak.
Leave diagram/chart for all things you can draw, e.g. for various graphical charts terminology: flow charts, ERD, etc.
How can you translate "build version" then?
"Build" is the result. "version" is the name you give for one of those result.
Just leave build in italic. build pengembangan and build produksi are fine for those.
"Build" is the result. "version" is the name you give for one of those result.
Just leave build in italic. build pengembangan and build produksi are fine for those.
@lunmay yes, I agree with this. Adding this to the glossary now. Let's try and replace all translations to match this.
@gedeagas based on the "RSNI-glossarium", in the definition of "file" number 3.94, It is translatable as "berkas". You may consider to do an update for word listed below.
English
Indonesian
file
berkas
Reacted by Irwan Andriawan, Irfan Maulana and Annisa Feryannie
Activity
gedeagas commentedon Feb 8, 2019
Checkout the glossary
Common Terms
Propose new terms here:
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 commentedon Feb 8, 2019
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 commentedon Feb 8, 2019
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 commentedon Feb 8, 2019
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 commentedon Feb 8, 2019
@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 commentedon Feb 8, 2019
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 commentedon Feb 8, 2019
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:
But for standalone
Componentwe can just translate it toKomponen, 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 commentedon Feb 8, 2019
@regalius in my opinion, loanwords only need to be italicized when it is part of a paragraph only.
seikatsurugi commentedon Feb 9, 2019
Hi, should we translate "Function Component" into "Komponen Fungsi" or just let it be "Function Component"?
PS*: Also asking for "Class Component"
regalius commentedon Feb 9, 2019
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 commentedon Feb 9, 2019
I've added @gedeagas 's comment to the glossary, feel free to improve it!
mendoanjoe commentedon Feb 9, 2019
try using this ? I.G.3. @martinock
gedeagas commentedon Feb 11, 2019
@regalius @arfianadam
gimana ?
arfianadam commentedon Feb 11, 2019
@gedeagas contoh konteks kalimatnya seperti apa? Sekilas benar tapi kok jadi kepikiran kalau di konteks tertentu mungkin bisa berubah arti.
mnindrazaka commentedon Feb 11, 2019
how about
Fragment, should we translate it toPecahan?43 remaining items
resir014 commentedon Oct 14, 2019
@spondbob I agree with using versi pengembangan and versi produksi for those terms. Let's go with that!
I'm also adding one more suggestion after reading through the RSNI:
We currently have these translated to "pohon" in some pages, but since "tree" in many of these contexts refers to the diagram of things (i.e. DOM tree), we might as well standardise these terms as such.
paramithatm commentedon Oct 24, 2019
Hi, I want to ask what's the proper translation for feature flags ? Is it bendera fitur or flag fitur
Also, can we strive for consistency for words like
project -> proyek
object -> obyek
since there's still some translated pages that uses
objekandprojek.I also found some typo in pages. If it's alright can I make a different PR to fix them?
resir014 commentedon Oct 25, 2019
@paramithatm Sure, pull requests for spelling consistencies are always welcome!
resir014 commentedon Oct 25, 2019
Also, to reference @grikomsn's comment here:
The section on Hooks sees some similar paragraphs describing Hooks, but various contributors have their own version of translation. Here are PR diffs related to Hooks:
Diff for Using the State Hook (Translate Using the State Hook #28):
Diff for Using the Effect Hook (Translate Using the Effect Hook #38):
Diff for Hooks at a Glance (merged) (Translate Hooks at a Glance #88):
Diff for Rules of Hooks (merged) (Translate Rules of Hooks #53)
To make these consistent, I propose we change them all to this:
andriawan commentedon Feb 9, 2020
how we translate higher-order components in bahasa? should it be translated or leave it as is?
lunmay commentedon Feb 10, 2020
Call me old school, but I don't think we can translate DOM tree as "diagram DOM". It should stay as "pohon DOM", with its "root", induk, and anak.
Leave diagram/chart for all things you can draw, e.g. for various graphical charts terminology: flow charts, ERD, etc.
lunmay commentedon Feb 10, 2020
How can you translate "build version" then?
"Build" is the result. "version" is the name you give for one of those result.
Just leave build in italic. build pengembangan and build produksi are fine for those.
resir014 commentedon Feb 13, 2020
@lunmay yes, I agree with this. Adding this to the glossary now. Let's try and replace all translations to match this.
supercomputra commentedon Oct 4, 2020
@gedeagas based on the "RSNI-glossarium", in the definition of "file" number 3.94, It is translatable as "berkas". You may consider to do an update for word listed below.
[Beta] Added documentation for React.createFactory (#5120)
Add request, refresh yarn.lock (#2)
resir014 commentedon Apr 26, 2023
All discussion regarding style guide & glossary have been moved here:
#337
[-]Style Guide & Common Terms[/-][+][OLD] Style Guide & Common Terms[/+]docs(Hooks: useInsertionEffect): Fix misspelling in heading reactjs#2