Tradução da palavra State
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
- Domain
- documentation, localization
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:
- No Glossário o termo State não deve ser traduzido.
- 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"
- 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 é.
- Outros títulos de menus e páginas estão com Estado e não como State: choosing-the-state-structure
- PR que estou revisando: #849
- "State variables" é traduzido como "variáveis de estado", como em state-a-components-memory
Sugestão de soluções:
- 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)
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from reactjs/pt-br.react.dev
-
LDA RECICLAGEM Open
Difficulty 5/5 Over a week Newbie friendliness 10/100
reactjs/pt-br.react.dev#1144 · 2 comments ·
-
This link return 404 Open
Difficulty 1/5 Under an hour Newbie friendliness 45/100
reactjs/pt-br.react.dev#787 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 35/100
reactjs/pt-br.react.dev#711 · 2 comments · 3 reactions ·
-
Difficulty 1/5 1-3 hours Newbie friendliness 35/100
reactjs/pt-br.react.dev#694 · 1 comment ·