Skip to content

Commit 3bc567d

Browse files
authored
Merge pull request #187 from odsantos/conflicts-check-after-pr178
Resolve conflicts + updates after #178
2 parents 2def53f + cd8a26d commit 3bc567d

File tree

13 files changed

+54
-537
lines changed

13 files changed

+54
-537
lines changed

1-js/02-first-steps/04-variables/article.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Variáveis
22

3-
Na maioria das vezes, um aplicativo JavaScript precisa trabalhar com informações. Aqui estão dois exemplos:
3+
Na maioria das vezes, um aplicativo JavaScript precisa de trabalhar com informações. Aqui estão dois exemplos:
44
1. Uma loja online -- a informação pode incluir mercadorias vendidas e um carrinho de compras.
55
2. Uma aplicação de chat -- a informação pode incluir usuários, mensagens e muito mais.
66

@@ -80,7 +80,7 @@ let user = 'John'
8080

8181
Tecnicamente, todas estas variantes fazem a mesma coisa. Então, é uma questão de gosto pessoal e estética.
8282

83-
````smart header="`var` instead of `let`"
83+
````smart header="`var` em vez de `let`"
8484
Em scripts antigos, você também pode encontrar outra palavra-chave: `var` em vez de `let`:
8585

8686
```js
@@ -125,7 +125,7 @@ let hello = 'Olá Mundo!';
125125
let message;
126126
127127
*!*
128-
// copiar 'Olá Mundo' do hello para message
128+
// copiar 'Olá Mundo' de hello para message
129129
message = hello;
130130
*/!*
131131
@@ -143,17 +143,17 @@ Uma declaração repetida da mesma variável é um erro:
143143
let message = "Isto";
144144
145145
// um 'let' repetido conduz a um erro
146-
let message = "Aquilo"; // SyntaxError: 'message' has already been declared (Erro-de-sintaxe: 'message' já foi declarado)
146+
let message = "Aquilo"; // SyntaxError: 'message' has already been declared (Erro-de-sintaxe: 'message' já foi declarada)
147147
```
148-
Assim, nós devemos declarar uma variável uma única vez e depois fazer referência a ela sem o `let`.
148+
Assim, devemos declarar uma variável apenas uma vez e depois fazer referência a ela sem o `let`.
149149
````
150150

151151
```smart header="Linguagens funcionais"
152152
É interessante notar que existem linguagens de programação [funcionais](https://en.wikipedia.org/wiki/Functional_programming), como [Scala](http://www.scala-lang.org/) ou [Erlang](http://www.erlang.org/), que proíbem a modificação de valores de variáveis.
153153
154154
Em tais linguagens, uma vez que o valor é armazenado "na caixa", ele está lá para sempre. Se precisarmos de armazenar algo mais, a linguagem nos obriga a criar uma nova caixa (declarar uma nova variável). Não podemos reutilizar a antiga.
155155
156-
Embora possa parecer um pouco estranho à primeira vista, estas linguagens são bastante capazes de um desenvolvimento sério. Mais do que isso, há áreas como cálculos paralelos onde essa limitação confere certos benefícios. Estudar uma linguagem dessas (mesmo que você não esteja planejando usá-la em breve) é recomendado para ampliar a mente.
156+
Embora possa parecer um pouco estranho à primeira vista, estas linguagens são bastante capazes de um desenvolvimento sério. Mais do que isso, há áreas como cálculos paralelos onde essa limitação confere certos benefícios. Estudar alguma dessas linguagens (mesmo que você não esteja planejando usá-la em breve) é recomendado para ampliar a mente.
157157
```
158158

159159
## Nomeação de variável [#variable-naming]
@@ -170,7 +170,7 @@ let userName;
170170
let test123;
171171
```
172172

173-
Quando o nome contém várias palavras, [camelCase](https://en.wikipedia.org/wiki/CamelCase) é normalmente utilizado. Isto é: as palavras vão uma após a outra, cada palavra exceto a primeira que começa com uma letra maiúscula: `myVeryLongName`.
173+
Quando o nome contém várias palavras, o [camelCase](https://en.wikipedia.org/wiki/CamelCase) é normalmente utilizado. Isto é: as palavras vão uma após a outra, e cada palavra exceto a primeira começa com uma letra maiúscula: `myVeryLongName`.
174174

175175
O que é interessante -- o sinal de dólar `'$'` e o sublinhado `'_'` também podem ser usados em nomes. Eles são símbolos regulares, assim como letras, sem nenhum significado especial.
176176

@@ -203,11 +203,11 @@ let имя = '...';
203203
let 我 = '...';
204204
```
205205
206-
Tecnicamente, não há erro aqui, tais nomes são permitidos, mas há uma tradição internacional de usar o inglês em nomes de variáveis. Mesmo que estejamos escrevendo um pequeno script, ele pode ter uma longa vida pela frente. Pessoas de outros países podem precisar lê-lo em algum momento.
206+
Tecnicamente, não há erro aqui. Tais nomes são permitidos, mas há uma tradição internacional de usar o inglês em nomes de variáveis. Mesmo que estejamos escrevendo um pequeno script, ele pode ter uma longa vida pela frente. Pessoas de outros países podem precisar de o ler em algum momento.
207207
````
208208

209209
````warn header="Nomes reservados"
210-
Existe uma [lista de palavras reservadas](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Keywords), que não pode ser usada como nomes de variáveis porque elas são usadas pela própria linguagem.
210+
Existe uma [lista de palavras reservadas](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Keywords), que não podem ser usadas como nomes de variáveis porque elas são usadas pela própria linguagem.
211211
212212
Por exemplo: `let`, `class`, `return`, e `function` são reservadas.
213213
@@ -221,7 +221,7 @@ let return = 5; // também não pode nomear como "return", erro!
221221

222222
````warn header="Uma atribuição sem `use strict`"
223223

224-
Normalmente, precisamos definir uma variável antes de usá-la. Mas nos velhos tempos, era tecnicamente possível criar uma variável através de uma mera atribuição do valor sem usar `let`. Isso ainda funciona se não colocarmos `use strict` em nossos scripts para manter a compatibilidade com scripts antigos.
224+
Normalmente, precisamos definir uma variável antes de a usar. Mas nos velhos tempos, era tecnicamente possível criar uma variável através de uma mera atribuição de valor, sem usar `let`. Isso ainda funciona se não colocarmos `use strict` em nossos scripts para manter a compatibilidade com scripts antigos.
225225

226226
```js run no-strict
227227
// nota: nenhum "use strict" neste exemplo
@@ -258,7 +258,7 @@ const myBirthday = '18.04.1982';
258258
myBirthday = '01.01.2001'; // erro, não é possível reatribuir a constante!
259259
```
260260
261-
Quando um programador está certo que uma variável nunca mudará, ele pode declará-la com `const` para garantir e comunicar claramente esse fato a todos.
261+
Quando um programador está certo de que uma variável nunca mudará, ele pode declará-la com `const` para garantir e comunicar claramente esse fato a todos.
262262
263263
264264
### Constantes maiúsculas
@@ -297,17 +297,17 @@ const pageLoadTime = /* tempo necessário para carregar uma página web */;
297297
298298
O valor de `pageLoadTime` não é conhecido antes do carregamento da página, portanto é nomeado normalmente. Mas ainda é uma constante porque não muda após a atribuição.
299299
300-
Em outras palavras, constantes com nomes maiúsculos são usadas apenas como pseudônimos para valores "codificação rígida".
300+
Em outras palavras, constantes com nomes maiúsculos são usadas apenas como pseudônimos para valores de "codificação rígida".
301301
302302
## Nomeie as coisas como devem ser
303303
304304
Falando em variáveis, há mais uma coisa extremamente importante.
305305
306306
O nome de uma variável deveria ter um significado claro e óbvio, descrevendo os dados que ela armazena.
307307
308-
A nomenclatura variável é uma das habilidades mais importantes e complexas em programação. Uma rápida olhada em nomes de variáveis pode revelar qual código foi escrito por um iniciante versus um desenvolvedor experiente.
308+
A nomenclatura variável é uma das habilidades mais importantes e complexas em programação. Uma rápida olhada em nomes de variáveis pode revelar que código foi escrito por um iniciante versus um desenvolvedor experiente.
309309
310-
Em um projeto real, a maior parte do tempo é gasto modificando e estendendo uma base de código existente ao invés de escrever algo completamente separado do zero. Quando voltamos a algum código depois de fazer outra coisa por um tempo, é muito mais fácil encontrar informações bem rotuladas. Ou, em outras palavras, quando as variáveis têm bons nomes.
310+
Em um projeto real, a maior parte do tempo é gasto modificando e estendendo uma base de código existente ao invés de escrever algo completamente separado do zero. Quando voltamos a algum código depois de fazer outra coisa por um tempo, é muito mais fácil encontrar informação se for bem rotulada. Ou, em outras palavras, quando as variáveis têm bons nomes.
311311
312312
Por favor, gaste tempo pensando sobre o nome certo para uma variável antes de declará-lo. Fazê-lo irá recompensá-lo generosamente.
313313
@@ -327,7 +327,7 @@ Como resultado, suas variáveis são como caixas em que as pessoas jogam coisas
327327
328328
Tais programadores economizam um pouco na declaração de variáveis, mas perdem dez vezes mais na depuração.
329329
330-
Uma variável extra é o bom, não ruim.
330+
Uma variável extra é bom, não ruim.
331331
332332
Os minificadores e navegadores JavaScript modernos otimizam o código o suficiente para que ele não crie problemas de desempenho. Usar variáveis diferentes para valores diferentes pode até mesmo ajudar o mecanismo a otimizar seu código.
333333
```

0 commit comments

Comments
 (0)