Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Diretrizes ao traduzir "state" precisam ser adicionadas ao repositório #689

Open
NivaldoFarias opened this issue May 14, 2023 · 1 comment

Comments

@NivaldoFarias
Copy link
Contributor

Novas Diretrizes

A Premissa

ok, existe um "problema" com as traduções no repo num geral que precisa ser endereçado: os padrões/diretrizes de como traduzir "state".

No GLOSSARY.md, a palavra é apenas referenciada como uma que não deve ser traduzida. Este padrão não têm sido empregado através das traduções, então supõe-se que não é uma diretriz tão indexada.

Talvez por isso, através das traduções já aplicadas (que não necessariamente já são o produto final) é evidente a inexistência de um padrão a ser empregado ao traduzir "state", uns traduzem para estado, outros mantém state (neste, se dividem entre utilizar ou não itálico).

Aprofundamento

No final, claro que caberá aos maintainers estipular as diretrizes, mas vale ressaltar alguns pontos como comunidade:

  1. É comum entre línguas latinas a tradução de state para a palavra nativa respectiva (no nosso caso, estado).
  2. Já existe conflitos no emprego de tradução (ou não) da palavra entre páginas no repositório, o que pode gerar confusão no leitor por não haver uma correlação explícita e direta.
  3. Por ser uma palavra extremamente comum nas documentações React, acredito ser de altíssima importância que algum padrão mínimo seja criado (mesmo que seja uma diretirz breve e temporária, enquanto uma mais aprofundada está sendo feita).

O que acredito que deve ser feito

Como mencionado, acredito que seja necessário que, no mínimo, novas diretrizes sejam empregadas de forma que endereçem explicidamente este caso, aplicando padrões ao repositório para contribuições que traduzam "state". (por ex. uma nova seção em GLOSSARY.md a respeito, etc.). Este passo não somente aprimoraria o conteúdo em si, mas daria a nós, a comunidade, maior orientação ao traduzir as páginas da documentação.

Sobre os amigos Espanhóis

Brevemente mencionei a wiki do repositório da tradução das docs React em Espanhol, mas acredito que eles merecem mais atenção (principalmente em como eles organizam a wiki). Existem alguns pontos que vejo muito valor se nós aplicássemos de forma análoga:

  1. Uma WIKI: mereceria uma aba de discussões própria, mas tudo abaixo corresponde à pontos que seriam mais facilmente aplicados em docs numa wiki aqui no github.
  2. Um glossário mais aprofundado: não só isso, mas também incluindo seções individuais para casos mais comuns (e que geram mais dúvida). No glossário espanhol, elencam uma por*ada a mais de traduções comuns (incluindo state), além de incluírem seções a respeito de traduções que comunmente geram dúvidas em PRs (support e instead).
  3. Guia de estilo: esse é mais óbvio, até porque eles separam por completo do glossário em si. Aqui, incluiríamos conteúdo similar ao encontrado na wiki espanhola (e traduzido, claro).
  4. Progresso Geral da Tradução: esse é opcional, até porque não existe uma enorme quantidade de issues, então é fácil encontrar o fórum com o progresso. Mas, de qualquer forma, incluir redirecionamentos nunca é demais.
@NivaldoFarias NivaldoFarias changed the title Diretrizes ao traduzir **_State_** precisam ser adicionadas ao repositório Diretrizes ao traduzir *state* precisam ser adicionadas ao repositório May 14, 2023
@NivaldoFarias NivaldoFarias changed the title Diretrizes ao traduzir *state* precisam ser adicionadas ao repositório Diretrizes ao traduzir _state_ precisam ser adicionadas ao repositório May 14, 2023
@NivaldoFarias NivaldoFarias changed the title Diretrizes ao traduzir _state_ precisam ser adicionadas ao repositório Diretrizes ao traduzir state precisam ser adicionadas ao repositório May 14, 2023
@NivaldoFarias NivaldoFarias changed the title Diretrizes ao traduzir state precisam ser adicionadas ao repositório Diretrizes ao traduzir "state" precisam ser adicionadas ao repositório May 14, 2023
@natrodrigo
Copy link
Contributor

Boa noite, @NivaldoFarias !
Acho que a wiki seria uma boa mesmo.

Já sobre a questão de state, não acho que faça sentido traduzi-lo sempre, mas acredito que o contexto de onde essa palavra está sendo utilizada também deve ser observado. Por exemplo, quando se está falando de state como o estado de algo 'genérico', acredito que ele deve ser traduzido, mas quando se referindo a de fato um state dentro do contexto de React, essa palavra deve ser mantida no seu original. Assim como não traduzimos código, termos usados em código também não deveriam ser traduzidos. Apesar dos nossos amigos espanhóis traduzirem state, eles não fazem isso com muitas outras palavras que seguem a mesma lógica do termo state (como: array, bundler, callback), então na verdade acredito que deveria haver um padrão exato para se seguir.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants