Skip to content

Commit 32a2890

Browse files
committed
docs: Added and properly adapted the GLOSSARY.md file originally from the reactjs.org/pt-BR.reactjs.org guidelines
1 parent b4d033f commit 32a2890

File tree

1 file changed

+144
-0
lines changed

1 file changed

+144
-0
lines changed

GLOSSARY.md

+144
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
# Guia de Estilo Universal
2+
3+
## Texto em Blocos de Código
4+
5+
Mantenha o texto em blocos de código sem tradução, exceto para os comentários. Você pode optar por traduzir o texto em strings, mas tenha cuidado para não traduzir strings que se refiram ao código!
6+
7+
Exemplo:
8+
9+
```js
10+
// Example
11+
const element = <h1>Hello, world</h1>;
12+
ReactDOM.render(element, document.getElementById('root'));
13+
```
14+
15+
✅ FAÇA:
16+
17+
```js
18+
// Exemplo
19+
const element = <h1>Hello, world</h1>;
20+
ReactDOM.render(element, document.getElementById('root'));
21+
```
22+
23+
✅ PERMITIDO:
24+
25+
```js
26+
// Exemplo
27+
const element = <h1>Olá mundo</h1>;
28+
ReactDOM.render(element, document.getElementById('root'));
29+
```
30+
31+
❌ NÃO FAÇA:
32+
33+
```js
34+
// Exemplo
35+
const element = <h1>Olá mundo</h1>;
36+
// "root" se refere a um ID de elemento.
37+
// NÃO TRADUZA
38+
ReactDOM.render(element, document.getElementById('raiz'));
39+
```
40+
41+
❌ DEFINITIVAMENTE NÃO FAÇA:
42+
43+
```js
44+
// Exemplo
45+
const elemento = <h1>Olá mundo</h1>;
46+
ReactDOM.renderizar(elemento, documento.obterElementoPorId('raiz'));
47+
```
48+
49+
## Links Externos
50+
51+
Se um link externo se referir a um artigo no [MDN] or [Wikipedia] e se houver uma versão traduzida em seu idioma em uma qualidade decente, opte por usar a versão traduzida.
52+
53+
[mdn]: https://developer.mozilla.org/pt-BR/
54+
[wikipedia]: https://pt.wikipedia.org/wiki/Wikipédia:Página_principal
55+
56+
Exemplo:
57+
58+
```md
59+
React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object).
60+
```
61+
62+
✅ OK:
63+
64+
```md
65+
Elementos React são [imutáveis](https://pt.wikipedia.org/wiki/Objeto_imutável).
66+
```
67+
68+
Para links que não possuem tradução (Stack Overflow, vídeos do YouTube, etc.), simplesmente use o link original.
69+
70+
## Traduções Comuns
71+
72+
Sugestões de palavras e termos:
73+
74+
| Palavra/Termo original | Sugestão |
75+
| ---------------------- | -------------------------------------- |
76+
| assertion | asserção |
77+
| browser | navegador |
78+
| bubbling | propagar |
79+
| bug | erro |
80+
| class component | componente de classe |
81+
| class | classe |
82+
| client | cliente |
83+
| client-side | lado do cliente |
84+
| container | contêiner |
85+
| context | contexto |
86+
| controlled component | componente controlado |
87+
| debugging | depuração |
88+
| DOM node | nó do DOM |
89+
| event handler | manipulador de eventos (event handler) |
90+
| function component | componente de função |
91+
| handler | manipulador |
92+
| helper function | função auxiliar |
93+
| high-order components | componente de alta-ordem |
94+
| key | chave |
95+
| library | biblioteca |
96+
| lowercase | minúscula(s) / caixa baixa |
97+
| package | pacote |
98+
| React element | Elemento React |
99+
| React fragment | Fragmento React |
100+
| render | renderizar (verb), renderizado (noun) |
101+
| server | servidor |
102+
| server-side | lado do servidor |
103+
| siblings | irmãos |
104+
| stateful component | componente com estado |
105+
| stateful logic | lógica com estado |
106+
| to assert | afirmar |
107+
| to wrap | encapsular |
108+
| uncontrolled component | componente não controlado |
109+
| uppercase | maiúscula(s) / caixa alta |
110+
111+
## Conteúdo que não deve ser traduzido
112+
113+
- array
114+
- arrow function
115+
- bind
116+
- bundle
117+
- bundler
118+
- callback
119+
- camelCase
120+
- DOM
121+
- event listener
122+
- framework
123+
- hook
124+
- log
125+
- mock
126+
- portal
127+
- props
128+
- ref
129+
- release
130+
- script
131+
- single-page-apps
132+
- state
133+
- string
134+
- string literal
135+
- subscribe
136+
- subscription
137+
- template literal
138+
- timestamps
139+
- UI
140+
- watcher
141+
- widgets
142+
- wrapper
143+
144+
Se deseja agregar algo que falta, abra um [issue](https://github.com/typescript-cheatsheets/react-pt/issues/new).

0 commit comments

Comments
 (0)