Tradução da palavra State

Open
#1,075 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Stale
Tech stack
react

Research direction

Start with GLOSSARY.md, discussion #689, PR #849, and the linked pages updating-objects-in-state, choosing-the-state-structure, and state-a-components-memory. Compare the menu labels, titles, and body terminology against the proposed convention. Done would require an agreed rule and consistent updates across the affected documentation, but this issue does not identify the full set of files to change.

Written by the indexing model from the issue text.

Description

Olá, estou iniciando minha colaboração agora no projeto. Uma dúvida que me surgiu logo inicialmente é a tradução do State, termo comum na documentação.

Fatos:
  1. No Glossário o termo State não deve ser traduzido.
  2. Na discussão #689 fica a cargo da compreensão do contexto: "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"
  3. Em produção temos os dois usos como na página updating-objects-in-state, em que no menu é traduzido, no título não é.
  4. Outros títulos de menus e páginas estão com Estado e não como State: choosing-the-state-structure
  5. PR que estou revisando: #849
  6. "State variables" é traduzido como "variáveis de estado", como em state-a-components-memory
Sugestão de soluções:
  1. Coerente com a regra (preferencial): Entendo que State mesmo no título diz respeito ao conceito State do React, logo não deve ser traduzido. Inclusive não é um hábito brasileiro traduzir alguns termos em inglês e sim incorporá-los, diferente de português de Portugal (🖱️ mouse x rato)
  2. Coerente com traduções anteriores: Manter como Estado no título e usar state|estado no texto conforme contexto.
Sugestão Futura
  • Padronizar a regra corrigindo em páginas já traduzidas.
  • Ajustar os itens do menu de acordo com o título da página.

Observação para heurística de usabilidade que pode ajudar nesta definição:
4: Consistency and Standards: Users should not have to wonder whether different words, situations, or actions mean the same thing. Follow platform and industry conventions.


Para agilizar o andamento das revisões, vou seguir a solução 1. Fica aqui o registro. Caso alguém mude o entendimento nessa issue, voltamos a correções ou mudamos o estilo de revisão.

Dominant language
JavaScript
Stars
538
Forks
324
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from reactjs/pt-br.react.dev

All issues in reactjs/pt-br.react.dev

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.