Glossary and Style Guide

[WendellAdriel]

Style Guide

• Leave code blocks untranslated. (It is usually OK to translate comments inside them. edit by @cezaraugusto: also strings inside HTML/JSX can also pass but use your best judgement)
• Links to references (MDN, Wikipedia) should go to the Portuguese version.
• When referring to React itself, use o React.

Common Translations

Suggestion on words and terms:

Original word/term	Suggestion
bug	erro
class	classe
context	contexto
controlled component	componente controlado
debugging	depuração
functional component	componente funcional
key	chave
library	biblioteca
lowercase	minúscula(s)
package	pacote
React element	Elemento React
React fragment	Fragmento React
render	renderizar (verb), renderizado (noun)
uncontrolled component	componente não controlado

Content that doesn't need translation

• array
• arrow function
• bind
• bundle
• bundler
• camelCase
• callback
• DOM
• framework
• hook
• mock
• portal
• props
• ref
• state
• string
• template literal
• UI
• log

[eduardomoroni]

is bind one of them?

[WendellAdriel]

I think that bind needs to be translated, something link vincular, do you agree with that @eduardomoroni? we can put on the suggested list

[eduardomoroni]

If you take a look at this translation proposal #3, sometimes it makes sense to not translate bind, because you might be referencing the bind method.
But we translate bound and translate only the past tense, then the reading can be confusing for those who don't know what bind means.

I don't know what is the better way to approach honestly, but I think that making use of:

os métodos de classe que não foram bind

instead of

os métodos de classe que não foram vinculados

Can be friendlier for those with no knowledge of English and/or JS. Because people will understand that we're talking about the bind method.

[WendellAdriel]

I understood the issue. I finished reading the translation proposal now and yeah, it can be confusing. I think that bind can be a word that we won't translate.

We can also use os métodos de classe que não foram feito bind.

I'll add that to the glossary

[glaucia86]

I think that bind needs to be translated, something link vincular, do you agree with that @eduardomoroni? we can put on the suggested list

Agree w/ @eduardomoroni many of video tutorials in portuguese teachs as 'bind'. I think unnecessary translate this word to portuguese.

[WendellAdriel]

I want your opinions on this one: the verb log, what do you think is the best option to translate this one? @glaucia86, @eduardomoroni?

[rafaelquintanilha]

I want your opinions on this one: the verb log, what do you think is the best option to translate this one? @glaucia86, @eduardomoroni?

I don't think this has a good translation (mainly if you consider its etymology as a reference to wooden logs). My suggestion is that we treat it as a noun, like "adicionar ao log", "remover do log", etc.

[eduardomoroni]

I think we don't need to translate log as well, I remember the first time someone translated Arcabouço in a talk, It took me like 5min to understand that they were talking about a framework.
I someone doesn't understand log, they could easily google for it and figure out for themselves.

[WendellAdriel]

Yeah, I was thinking about that, but when we have something like "logs SOMETHING to the console". Which expression can I use to refer to that? I mean, what's the best option?

[rafaelquintanilha]

Yeah, I was thinking about that, but when we have something like "logs SOMETHING to the console". Which expression can I use to refer to that? I mean, what's the best option?

I was thinking about that when I was trying to translate print. Feels really weird to say imprimir even if the translation is pretty accurate (feels like people always say printar). Maybe we can unify both cases and say imprimir no console (the least bad translation I can think of).

[WendellAdriel]

Yeah, I was thinking about two options:

• escrever no console
• imprimir no console