Resolve conflicts + Updates after #178

Author: odsantos

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

@@ -1,6 +1,6 @@
 # Variáveis
 
-Na maioria das vezes, um aplicativo JavaScript precisa trabalhar com informações. Aqui estão dois exemplos:
+Na maioria das vezes, um aplicativo JavaScript precisa de trabalhar com informações. Aqui estão dois exemplos:
 1. Uma loja online -- a informação pode incluir mercadorias vendidas e um carrinho de compras.
 2. Uma aplicação de chat -- a informação pode incluir usuários, mensagens e muito mais.
 
@@ -12,11 +12,7 @@ Uma [variável](https://pt.wikipedia.org/wiki/Variável_(programação)) é um "
 
 Para criar uma variável em JavaScript, use a palavra-chave `let`.
 
-<<<<<<< HEAD
-A declaração abaixo cria (em outras palavras: * declara * ou * define *) uma variável com o nome "message":
-=======
-The statement below creates (in other words: *declares*) a variable with the name "message":
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3
+A declaração abaixo cria (em outras palavras: *declara*) uma variável com o nome "message":
 
 ```js
 let message;
@@ -74,7 +70,7 @@ let user = 'John',
   message = 'Olá';
 ```
 
-... Ou até mesmo no estilo "comma-first":
+... Ou até mesmo no estilo "vírgula-primeiro":
 
 ```js no-beautify
 let user = 'John'
@@ -84,7 +80,7 @@ let user = 'John'
 
 Tecnicamente, todas estas variantes fazem a mesma coisa. Então, é uma questão de gosto pessoal e estética.
 
-````smart header="`var` instead of `let`"
+````smart header="`var` em vez de `let`"
 Em scripts antigos, você também pode encontrar outra palavra-chave: `var` em vez de `let`:
 
 ```js
@@ -129,7 +125,7 @@ let hello = 'Olá Mundo!';
 let message;
 
 *!*
-// copiar 'Olá Mundo' do hello para message
+// copiar 'Olá Mundo' de hello para message
 message = hello;
 */!*
 
@@ -138,31 +134,26 @@ alert(hello); // Olá Mundo!
 alert(message); // Olá Mundo!
 ```
 
-<<<<<<< HEAD
-```smart header="Linguagens funcionais"
-É interessante notar que linguagens de programação [funcional](https://en.wikipedia.org/wiki/Functional_programming), como [Scala](http://www.scala-lang.org/) or [Erlang](http://www.erlang.org/), proibem a modificação de valores de variáveis.
-=======
-````warn header="Declaring twice triggers an error"
-A variable should be declared only once.
+````warn header="Declarar duas vezes lança um erro"
+Uma variável deve ser declarada apenas uma vez.
 
-A repeated declaration of the same variable is an error:
+Uma declaração repetida da mesma variável é um erro:
 
 ```js run
-let message = "This";
+let message = "Isto";
 
-// repeated 'let' leads to an error
-let message = "That"; // SyntaxError: 'message' has already been declared
+// um 'let' repetido conduz a um erro
+let message = "Aquilo"; // SyntaxError: 'message' has already been declared (Erro-de-sintaxe: 'message' já foi declarada)
 ```
-So, we should declare a variable once and then refer to it without `let`.
+Assim, devemos declarar uma variável apenas uma vez e depois fazer referência a ela sem o `let`.
 ````
 
-```smart header="Functional languages"
-It's interesting to note that there exist [functional](https://en.wikipedia.org/wiki/Functional_programming) programming languages, like [Scala](http://www.scala-lang.org/) or [Erlang](http://www.erlang.org/) that forbid changing variable values.
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3
+```smart header="Linguagens funcionais"
+É 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.
 
 Em tais linguagens, uma vez que o valor é armazenado "na box", ele está lá para sempre. Se precisarmos de armazenar algo mais, a linguagem nos obriga a criar uma nova box (declarar uma nova variável). Não podemos reutilizar a antiga.
 
-Embora possa parecer um pouco estranho à primeira vista, estas línguas 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 tal linguagem (mesmo que você não esteja planejando usá-la em breve) é recomendado para ampliar a mente.
+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.
 ```
 
 ## Nomeação de variável [#variable-naming]
@@ -179,7 +170,7 @@ let userName;
 let test123;
 ```
 
-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`.
+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`.
 
 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.
 
@@ -204,23 +195,19 @@ let my-name; // hífens '-' não são permitidos no nome
 Variáveis chamadas `apple` e `AppLE` são duas variáveis diferentes.
 ```
 
-````smart header="Letras não inglesas são permitidas, mas não são recomendadas"
+````smart header="Letras de alfabeto não-Latin são permitidas, mas não são recomendadas"
 É possível usar qualquer idioma, incluindo letras cirílicas ou até hieróglifos, como este:
 
 ```js
 let имя = '...';
 let 我 = '...';
 ```
 
-<<<<<<< HEAD
-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.
-=======
-Technically, there is no error here. Such names are allowed, but there is an international convention to use English in variable names. Even if we're writing a small script, it may have a long life ahead. People from other countries may need to read it some time.
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3
+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.
 ````
 
 ````warn header="Nomes reservados"
-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.
+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.
 
 Por exemplo: `let`, `class`, `return`, e `function` são reservadas.
 
@@ -234,7 +221,7 @@ let return = 5; // também não pode nomear como "return", erro!
 
 ````warn header="Uma atribuição sem `use strict`"
 
-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.
+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.
 
 ```js run no-strict
 // nota: nenhum "use strict" neste exemplo
@@ -263,19 +250,15 @@ Para declarar uma variável constante (imutável), use `const` em vez de `let`:
 const myBirthday = '18.04.1982';
 ```
 
-<<<<<<< HEAD
 Variáveis declaradas usando `const` são chamadas de "constantes". Elas não podem ser alteradas. Uma tentativa de fazer isso causaria um erro:
-=======
-Variables declared using `const` are called "constants". They cannot be reassigned. An attempt to do so would cause an error:
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3
 
 ```js run
 const myBirthday = '18.04.1982';
 
 myBirthday = '01.01.2001'; // erro, não é possível reatribuir a constante!
 ```
 
-Quando um programador é certo que uma variável nunca mudará, eles podem declará-la com `const` para garantir e comunicar claramente esse fato a todos.
+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.
 
 
 ### Constantes maiúsculas
@@ -314,21 +297,17 @@ const pageLoadTime = /* tempo necessário para carregar uma página web */;
 
 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.
 
-Em outras palavras, constantes com nomes maiúsculos são usadas apenas como pseudônimos para valores "codificação rígida". 
+Em outras palavras, constantes com nomes maiúsculos são usadas apenas como pseudônimos para valores de "codificação rígida".
 
 ## Nomeie as coisas como devem ser
 
 Falando em variáveis, há mais uma coisa extremamente importante.
 
-<<<<<<< HEAD
-Por favor, nomeie as suas variáveis de forma sensata. Tome tempo para pensar sobre isso.
-=======
-A variable name should have a clean, obvious meaning, describing the data that it stores.
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3
+O nome de uma variável deve ter um significado claro e óbvio, descrevendo os dados que ela armazena.
 
-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.
+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.
 
-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.
+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.
 
 Por favor, gaste tempo pensando sobre o nome certo para uma variável antes de declará-lo. Fazê-lo irá recompensá-lo generosamente.
 
@@ -348,7 +327,7 @@ Como resultado, suas variáveis são como caixas em que as pessoas jogam coisas
 
 Tais programadores economizam um pouco na declaração de variáveis, mas perdem dez vezes mais na depuração.
 
-Uma variável extra é o bom, não ruim.
+Uma variável extra é bom, não ruim.
 
 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.
 ```

1-js/02-first-steps/06-alert-prompt-confirm/article.md

@@ -4,11 +4,7 @@ As we'll be using the browser as our demo environment, let's see a couple of fun
 
 ## alert
 
-<<<<<<< HEAD:1-js/02-first-steps/06-alert-prompt-confirm/article.md
-This one we've seen already. It shows a message and waits for the user to presses "OK".
-=======
 This one we've seen already. It shows a message and waits for the user to press "OK".
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3:1-js/02-first-steps/06-alert-prompt-confirm/article.md
 
 For example:
 
@@ -35,11 +31,7 @@ It shows a modal window with a text message, an input field for the visitor, and
 : An optional second parameter, the initial value for the input field.
 
 ```smart header="The square brackets in syntax `[...]`"
-<<<<<<< HEAD:1-js/02-first-steps/06-alert-prompt-confirm/article.md
-The square brackets around `default` in the syntax above denote that the parameter as optional, not required.
-=======
 The square brackets around `default` in the syntax above denote that the parameter is optional, not required.
->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3:1-js/02-first-steps/06-alert-prompt-confirm/article.md
 ```
 
 The visitor can type something in the prompt input field and press OK. Then we get that text in the `result`. Or they can cancel the input by pressing Cancel or hitting the `key:Esc` key, then we get `null` as the `result`.