Sep 27, 2022 · Sep 28, 2022 · Sep 28, 2022 · Sep 29, 2022 · Sep 29, 2022 · Sep 29, 2022
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
 github:iliakan
diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md

 Os interpretadores são complicados. Mas o básico é fácil.

 <<<<<<< HEAD
 1. O interpretador (embutido se for um navegador) lê ("analisa") o script.
 2. Depois converte ("compila") o script para a linguagem da máquina.
 3. E então o código da máquina é executado, bem rápido.
 =======
 1. The engine (embedded if it's a browser) reads ("parses") the script.
 2. Then it converts ("compiles") the script to machine code.
 3. And then the machine code runs, pretty fast.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 O interpretador aplica otimizações em cada etapa do processo. Ele ainda observa o script compilado enquanto ele roda, analisa os dados que passam por ele e aplica otimizações ao código da máquina com base nesse conhecimento.
 ```

 ## O que o JavaScript no navegador pode fazer?

 <<<<<<< HEAD
 JavaScript moderno é uma linguagem de programação "segura". Ele não fornece acesso de baixo nível à memória ou CPU, porque foi inicialmente criado para navegadores que não necessitam dele.
 =======
 Modern JavaScript is a "safe" programming language. It does not provide low-level access to memory or the CPU, because it was initially created for browsers which do not require it.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 As capacidades do JavaScript dependem muito do ambiente em que está sendo executado. Por exemplo, [Node.js]https://pt.wikipedia.org/wiki/Node.js) suporta funções que permitem ao JavaScript ler/gravar arquivos arbitrários, executar solicitações de rede, etc.


 ## O que o JavaScript no navegador não pode fazer?

 <<<<<<< HEAD
 As habilidades do JavaScript no navegador são limitadas por uma questão de segurança do usuário. O objetivo é evitar que uma página maléfica acesse informações privadas ou prejudique os dados do usuário.
 =======
 JavaScript's abilities in the browser are limited to protect the user's safety. The aim is to prevent an evil webpage from accessing private information or harming the user's data.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 Exemplos de tais restrições incluem:

 - JavaScript em uma página não pode ler/gravar arquivos arbitrários no disco rígido, copiá-los ou executar programas. Não tem acesso direto às funções do sistema operacional.

    Os navegadores modernos permitem que ele trabalhe com arquivos, mas o acesso é limitado e fornecido apenas se o usuário executar determinadas ações, como "dropping" de um arquivo em uma janela do navegador ou selecioná-lo por meio de uma tag `<input>`.

 <<<<<<< HEAD
   Existem maneiras de interagir com a câmera / microfone e outros dispositivos, mas eles exigem permissão explícita do usuário. Assim, uma página habilitada para JavaScript pode não habilmente habilitar uma câmera web, observar os arredores e enviar as informações para a [NSA](https://pt.wikipedia.org/wiki/Ag%C3%AAncia_de_Seguran%C3%A7a_Nacional).
 - Diferentes abas/janelas geralmente não se conhecem mutuamente. Às vezes sim, por exemplo, quando uma janela usa JavaScript para abrir a outra. Mas mesmo neste caso, JavaScript de uma página pode não acessar a outra se eles vierem de sites diferentes (de um domínio, protocolo ou porta diferente).

 ![](limitations.svg)

 Esses limites não existem se o JavaScript for usado fora do navegador, por exemplo, em um servidor. Os navegadores modernos também permitem plugins / extensões que podem solicitar permissões estendidas.
 =======
    There are ways to interact with the camera/microphone and other devices, but they require a user's explicit permission. So a JavaScript-enabled page may not sneakily enable a web-camera, observe the surroundings and send the information to the [NSA](https://en.wikipedia.org/wiki/National_Security_Agency).
 - Different tabs/windows generally do not know about each other. Sometimes they do, for example when one window uses JavaScript to open the other one. But even in this case, JavaScript from one page may not access the other page if they come from different sites (from a different domain, protocol or port).

    This is called the "Same Origin Policy". To work around that, *both pages* must agree for data exchange and must contain special JavaScript code that handles it. We'll cover that in the tutorial.

    This limitation is, again, for the user's safety. A page from `http://anysite.com` which a user has opened must not be able to access another browser tab with the URL `http://gmail.com`, for example, and steal information from there.
 - JavaScript can easily communicate over the net to the server where the current page came from. But its ability to receive data from other sites/domains is crippled. Though possible, it requires explicit agreement (expressed in HTTP headers) from the remote side. Once again, that's a safety limitation.

 ![](limitations.svg)

 Such limitations do not exist if JavaScript is used outside of the browser, for example on a server. Modern browsers also allow plugins/extensions which may ask for extended permissions.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ## O que torna o JavaScript único?


 Isso é o que torna o JavaScript único. É por isso que é a ferramenta mais difundida para criar interfaces de navegador.

 <<<<<<< HEAD
 Ao passo que planeja aprender uma nova tecnologia, é benéfico verificar suas perspectivas. Então, vamos seguir para as tendências modernas que o afetam, incluindo novas linguagens e habilidades de navegador.
 =======
 That said, JavaScript can be used to create servers, mobile applications, etc.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ## Linguagens "sobre" JavaScript

 A sintaxe do JavaScript não se adapta às necessidades de todos. Pessoas diferentes querem características diferentes.

 Isso é de se esperar, porque os projetos e requisitos são diferentes para todos.

 <<<<<<< HEAD
 Então, recentemente uma infinidade de novas linguagens apareceu, que são *transpiladas* (convertidas) para JavaScript antes de rodarem no navegador.
 =======
 So, recently a plethora of new languages appeared, which are *transpiled* (converted) to JavaScript before they run in the browser.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 Ferramentas modernas tornam a transpilação muito rápida e transparente, permitindo que os desenvolvedores codifiquem em outra linguagem e auto-convertendo-a "sob o capô".

 Exemplos de tais linguagens:

 <<<<<<< HEAD
 - [CoffeeScript](http://coffeescript.org/) é um "açúcar sintático" para JavaScript. Ele introduz uma sintaxe mais curta, permitindo-nos escrever um código mais claro e preciso. Normalmente, Ruby devs gostam dele.
 - [TypeScript](http://www.typescriptlang.org/) está concentrado em adicionar "estritos tipos de dados" para simplificar o desenvolvimento e suporte de sistemas complexos. É desenvolvido pela Microsoft.
 - [Flow](http://flow.org/) também adiciona tipos de dados, mas de uma forma diferente. Desenvolvido pela Facebook.
 - [Kotlin](https://kotlinlang.org/docs/js-overview.html) é uma linguagem de programação moderna, concisa e segura, que pode ser usada no navegador ou no Node.

 Há mais. Claro que, mesmo que usemos uma dessas linguagens transpiladas, também devemos saber JavaScript para entender o que estamos fazendo.
 =======
 - [CoffeeScript](https://coffeescript.org/) is "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
 - [TypeScript](https://www.typescriptlang.org/) is concentrated on adding "strict data typing" to simplify the development and support of complex systems. It is developed by Microsoft.
 - [Flow](https://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
 - [Dart](https://www.dartlang.org/) is a standalone language that has its own engine that runs in non-browser environments (like mobile apps), but also can be transpiled to JavaScript. Developed by Google.
 - [Brython](https://brython.info/) is a Python transpiler to JavaScript that enables the writing of applications in pure Python without JavaScript.
 - [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) is a modern, concise and safe programming language that can target the browser or Node.

 There are more. Of course, even if we use one of these transpiled languages, we should also know JavaScript to really understand what we're doing.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ## Resumo

diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md

 # Manuais e especificações

 <<<<<<< HEAD
 Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradualmente a linguagem. Mas uma vez familiarizado com o básico, irá precisar de outros recursos.
 =======
 This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other resources.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ## Especificação

 A [Especificação ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contém as mais profundas, detalhadas e formalizadas informações sobre JavaScript. Ela define a linguagem.

 Mas, estando num formato mais formal, fica difícil de entender à primeira vista. Porém, se você precisa da mais confiável fonte de informações sobre detalhes da linguagem, está no lugar certo. Contudo, não é para o uso cotidiano.

 <<<<<<< HEAD
 Uma nova versão dessa especificação é lançada todos os anos. Entre estes lançamentos, a sua última versão de esboço se encontra em <https://tc39.es/ecma262/>.
 =======
 A new specification version is released every year. Between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 Para ler sobre as mais novas funcionalidades (*bleeding-edge features*), incluindo as que estão em fase de padronização (chamadas também de "estágio 3"), veja as suas propostas em <https://github.com/tc39/proposals>.


 - **MDN (Mozilla) JavaScript Reference**  é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções da linguagem, métodos , etc.

 <<<<<<< HEAD
 Pode ser encontrado em <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.

 Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo: <https://google.com/search?q=MDN+parseInt> para procurar pela função `parseInt`.
 =======
    You can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.

 Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for the `parseInt` function.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ## Tabelas de compatibilidade

 JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente.

 Para verificar o suporte dessas funcionalidades entre interpretadores de JavaScript (*JavaScript engines*) para browsers ou para outras aplicações, veja em:

 <<<<<<< HEAD
 - <http://caniuse.com> - mostra uma tabela de compatibilidade por funcionalidade, por exemplo, para verificar quais interpretadores suportam funções de criptografia moderna: <http://caniuse.com/#feat=cryptography>.
 - <https://kangax.github.io/compat-table> - uma tabela com funcionalidades da linguagem e os interpretadores que as suportam ou não.

 Todos esses recursos são úteis no cotidiano do desenvolvedor, uma vez que eles contêm informações valiosas sobre os detalhes da linguagem, seu suporte, etc.
 =======
 - <https://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <https://caniuse.com/#feat=cryptography>.
 - <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.

 All these resources are useful in real-life development, as they contain valuable information about language details, their support, etc.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 Por favor, lembre-se deles (ou desta página) quando precisar de informações específicas sobre alguma funcionalidade.
diff --git a/1-js/01-getting-started/3-code-editors/article.md b/1-js/01-getting-started/3-code-editors/article.md

 Se você ainda não tiver selecionado uma IDE, considere as seguintes opções:

 <<<<<<< HEAD
 - [Visual Studio Code](https://code.visualstudio.com/) (plataforma cruzada, livre).
 - [WebStorm](https://www.jetbrains.com/pt-br/webstorm/) (plataforma cruzada, pago).
 =======
 - [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
 - [WebStorm](https://www.jetbrains.com/webstorm/) (cross-platform, paid).
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 Para Windows, há também "Visual Studio", que não deve ser confundido com "Visual Studio Code". "Visual Studio" é um editor pago e poderoso somente para Windows, bem adequado para a plataforma .NET . Uma versão gratuita é chamada [Visual Studio Community](https://visualstudio.microsoft.com/pt-br/vs/community/).


 Na prática, os editores leves podem ter muitos plug-ins, incluindo analisadores de sintaxe no nível de diretório e preenchimentos automáticos, portanto não há uma limitação rígida entre um editor leve e uma IDE.

 <<<<<<< HEAD
 As seguintes opções merecem sua atenção:

 - [Atom](https://atom.io/) (plataforma cruzada, livre).
 - [Sublime Text](http://www.sublimetext.com) (plataforma cruzada, shareware).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, livre).
 - [Vim](http://www.vim.org/) e [Emacs](https://www.gnu.org/software/emacs/) também são legais se você sabe como usá-los.
 =======
 There are many options, for instance:

 - [Sublime Text](https://www.sublimetext.com/) (cross-platform, shareware).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
 - [Vim](https://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ## Não vamos discutir

 Os editores nas listas acima são aqueles que eu ou os meus amigos que eu considero bons desenvolvedores têm usado por um longo tempo e estão felizes com eles.

 Há outros grandes editores no nosso grande mundo. Por favor, escolha o que você mais gosta.

 <<<<<<< HEAD
 A escolha de um editor, como qualquer outra ferramenta, é individual e depende de seus projetos, hábitos e preferências pessoais.
 =======
 The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.

 The author's personal opinion:

 - I'd use [Visual Studio Code](https://code.visualstudio.com/) if I develop mostly frontend.
 - Otherwise, if it's mostly another language/platform and partially frontend, then consider other editors, such as XCode (Mac), Visual Studio (Windows) or Jetbrains family (Webstorm, PHPStorm, RubyMine etc, depending on the language).
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19
diff --git a/1-js/01-getting-started/4-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md

 É parecido com isto:

 ![chrome](chrome.png)
 ![chrome](chrome.webp)

 O aspecto exato das ferramentas de desenvolvimento depende da sua versão do Chrome. Ele muda de vez em quando, mas deve ser semelhante.


 O Safari (navegador do Mac, não suportado pelo Windows/Linux) é um pouco especial aqui. Precisamos primeiro habilitar o "Develop menu".

 <<<<<<< HEAD
 Abra Preferências e vá para o painel "Avançado". Há uma caixa de seleção na parte inferior:
 =======
 Open Settings and go to the "Advanced" pane. There's a checkbox at the bottom:
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 ![safari](safari.png)

diff --git a/1-js/01-getting-started/4-devtools/chrome.png b/1-js/01-getting-started/4-devtools/chrome.png
diff --git a/1-js/01-getting-started/4-devtools/chrome.webp b/1-js/01-getting-started/4-devtools/chrome.webp
diff --git a/1-js/01-getting-started/4-devtools/chrome@2.webp b/1-js/01-getting-started/4-devtools/chrome@2.webp
diff --git a/1-js/01-getting-started/4-devtools/chrome@2x.png b/1-js/01-getting-started/4-devtools/chrome@2x.png
diff --git a/1-js/01-getting-started/4-devtools/safari.png b/1-js/01-getting-started/4-devtools/safari.png
diff --git a/1-js/01-getting-started/4-devtools/safari@2x.png b/1-js/01-getting-started/4-devtools/safari@2x.png
diff --git a/1-js/02-first-steps/04-variables/3-uppercast-constant/task.md b/1-js/02-first-steps/04-variables/3-uppercast-constant/task.md
 const age = someCode(birthday);
 ```

 <<<<<<< HEAD
 Aqui temos uma constante `birthday` e a `age` que é calculada apartir de `birthday` com a ajuda de algum código (não é fornecido por falta de tempo, e porque os detalhes não importam aqui).
 =======
 Here we have a constant `birthday` for the date, and also the `age` constant.

 The `age` is calculated from `birthday` using `someCode()`, which means a function call that we didn't explain yet (we will soon!), but the details don't matter here, the point is that `age` is calculated somehow based on the `birthday`.
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

 Seria correcto utilizar maiúsculas para `birthday`? Para `age`? Ou mesmo para ambos?

 ```js
 <<<<<<< HEAD
 const BIRTHDAY = '18.04.1982'; // fazer maiúsculas?

 const AGE = someCode(BIRTHDAY); // fazer maiúsculas?
 ```
 =======
 const BIRTHDAY = '18.04.1982'; // make birthday uppercase?

 const AGE = someCode(BIRTHDAY); // make age uppercase?
 >>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19
 ```
Original file line number	Diff line number	Diff line change
Expand Up		@@ -34,16 +34,26 @@ Os termos acima são bons para lembrar, pois são usados em artigos de desenvolv

		Os interpretadores são complicados. Mas o básico é fácil.

		<<<<<<< HEAD
		1. O interpretador (embutido se for um navegador) lê ("analisa") o script.
		2. Depois converte ("compila") o script para a linguagem da máquina.
		3. E então o código da máquina é executado, bem rápido.
		=======
		1. The engine (embedded if it's a browser) reads ("parses") the script.
		2. Then it converts ("compiles") the script to machine code.
		3. And then the machine code runs, pretty fast.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		O interpretador aplica otimizações em cada etapa do processo. Ele ainda observa o script compilado enquanto ele roda, analisa os dados que passam por ele e aplica otimizações ao código da máquina com base nesse conhecimento.
		```

		## O que o JavaScript no navegador pode fazer?

		<<<<<<< HEAD
		JavaScript moderno é uma linguagem de programação "segura". Ele não fornece acesso de baixo nível à memória ou CPU, porque foi inicialmente criado para navegadores que não necessitam dele.
		=======
		Modern JavaScript is a "safe" programming language. It does not provide low-level access to memory or the CPU, because it was initially created for browsers which do not require it.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		As capacidades do JavaScript dependem muito do ambiente em que está sendo executado. Por exemplo, [Node.js]https://pt.wikipedia.org/wiki/Node.js) suporta funções que permitem ao JavaScript ler/gravar arquivos arbitrários, executar solicitações de rede, etc.

Expand All		@@ -59,14 +69,19 @@ Por exemplo, o JavaScript no navegador é capaz de:

		## O que o JavaScript no navegador não pode fazer?

		<<<<<<< HEAD
		As habilidades do JavaScript no navegador são limitadas por uma questão de segurança do usuário. O objetivo é evitar que uma página maléfica acesse informações privadas ou prejudique os dados do usuário.
		=======
		JavaScript's abilities in the browser are limited to protect the user's safety. The aim is to prevent an evil webpage from accessing private information or harming the user's data.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		Exemplos de tais restrições incluem:

		- JavaScript em uma página não pode ler/gravar arquivos arbitrários no disco rígido, copiá-los ou executar programas. Não tem acesso direto às funções do sistema operacional.

		Os navegadores modernos permitem que ele trabalhe com arquivos, mas o acesso é limitado e fornecido apenas se o usuário executar determinadas ações, como "dropping" de um arquivo em uma janela do navegador ou selecioná-lo por meio de uma tag `<input>`.

		<<<<<<< HEAD
		Existem maneiras de interagir com a câmera / microfone e outros dispositivos, mas eles exigem permissão explícita do usuário. Assim, uma página habilitada para JavaScript pode não habilmente habilitar uma câmera web, observar os arredores e enviar as informações para a [NSA](https://pt.wikipedia.org/wiki/Ag%C3%AAncia_de_Seguran%C3%A7a_Nacional).
		- Diferentes abas/janelas geralmente não se conhecem mutuamente. Às vezes sim, por exemplo, quando uma janela usa JavaScript para abrir a outra. Mas mesmo neste caso, JavaScript de uma página pode não acessar a outra se eles vierem de sites diferentes (de um domínio, protocolo ou porta diferente).

Expand All		@@ -78,6 +93,19 @@ Exemplos de tais restrições incluem:
		![](limitations.svg)

		Esses limites não existem se o JavaScript for usado fora do navegador, por exemplo, em um servidor. Os navegadores modernos também permitem plugins / extensões que podem solicitar permissões estendidas.
		=======
		There are ways to interact with the camera/microphone and other devices, but they require a user's explicit permission. So a JavaScript-enabled page may not sneakily enable a web-camera, observe the surroundings and send the information to the [NSA](https://en.wikipedia.org/wiki/National_Security_Agency).
		- Different tabs/windows generally do not know about each other. Sometimes they do, for example when one window uses JavaScript to open the other one. But even in this case, JavaScript from one page may not access the other page if they come from different sites (from a different domain, protocol or port).

		This is called the "Same Origin Policy". To work around that, both pages must agree for data exchange and must contain special JavaScript code that handles it. We'll cover that in the tutorial.

		This limitation is, again, for the user's safety. A page from `http://anysite.com` which a user has opened must not be able to access another browser tab with the URL `http://gmail.com`, for example, and steal information from there.
		- JavaScript can easily communicate over the net to the server where the current page came from. But its ability to receive data from other sites/domains is crippled. Though possible, it requires explicit agreement (expressed in HTTP headers) from the remote side. Once again, that's a safety limitation.

		![](limitations.svg)

		Such limitations do not exist if JavaScript is used outside of the browser, for example on a server. Modern browsers also allow plugins/extensions which may ask for extended permissions.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		## O que torna o JavaScript único?

Expand All		@@ -92,20 +120,29 @@ JavaScript é a única tecnologia de navegador que combina estas três qualidade

		Isso é o que torna o JavaScript único. É por isso que é a ferramenta mais difundida para criar interfaces de navegador.

		<<<<<<< HEAD
		Ao passo que planeja aprender uma nova tecnologia, é benéfico verificar suas perspectivas. Então, vamos seguir para as tendências modernas que o afetam, incluindo novas linguagens e habilidades de navegador.
		=======
		That said, JavaScript can be used to create servers, mobile applications, etc.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		## Linguagens "sobre" JavaScript

		A sintaxe do JavaScript não se adapta às necessidades de todos. Pessoas diferentes querem características diferentes.

		Isso é de se esperar, porque os projetos e requisitos são diferentes para todos.

		<<<<<<< HEAD
		Então, recentemente uma infinidade de novas linguagens apareceu, que são transpiladas (convertidas) para JavaScript antes de rodarem no navegador.
		=======
		So, recently a plethora of new languages appeared, which are transpiled (converted) to JavaScript before they run in the browser.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		Ferramentas modernas tornam a transpilação muito rápida e transparente, permitindo que os desenvolvedores codifiquem em outra linguagem e auto-convertendo-a "sob o capô".

		Exemplos de tais linguagens:

		<<<<<<< HEAD
		- [CoffeeScript](http://coffeescript.org/) é um "açúcar sintático" para JavaScript. Ele introduz uma sintaxe mais curta, permitindo-nos escrever um código mais claro e preciso. Normalmente, Ruby devs gostam dele.
		- [TypeScript](http://www.typescriptlang.org/) está concentrado em adicionar "estritos tipos de dados" para simplificar o desenvolvimento e suporte de sistemas complexos. É desenvolvido pela Microsoft.
		- [Flow](http://flow.org/) também adiciona tipos de dados, mas de uma forma diferente. Desenvolvido pela Facebook.
Expand All		@@ -114,6 +151,16 @@ Exemplos de tais linguagens:
		- [Kotlin](https://kotlinlang.org/docs/js-overview.html) é uma linguagem de programação moderna, concisa e segura, que pode ser usada no navegador ou no Node.

		Há mais. Claro que, mesmo que usemos uma dessas linguagens transpiladas, também devemos saber JavaScript para entender o que estamos fazendo.
		=======
		- [CoffeeScript](https://coffeescript.org/) is "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
		- [TypeScript](https://www.typescriptlang.org/) is concentrated on adding "strict data typing" to simplify the development and support of complex systems. It is developed by Microsoft.
		- [Flow](https://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
		- [Dart](https://www.dartlang.org/) is a standalone language that has its own engine that runs in non-browser environments (like mobile apps), but also can be transpiled to JavaScript. Developed by Google.
		- [Brython](https://brython.info/) is a Python transpiler to JavaScript that enables the writing of applications in pure Python without JavaScript.
		- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) is a modern, concise and safe programming language that can target the browser or Node.

		There are more. Of course, even if we use one of these transpiled languages, we should also know JavaScript to really understand what we're doing.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		## Resumo

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,15 +1,23 @@

		# Manuais e especificações

		<<<<<<< HEAD
		Este livro é um tutorial. Ele tem como objetivo lhe ajudar a aprender gradualmente a linguagem. Mas uma vez familiarizado com o básico, irá precisar de outros recursos.
		=======
		This book is a tutorial. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other resources.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		## Especificação

		A [Especificação ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contém as mais profundas, detalhadas e formalizadas informações sobre JavaScript. Ela define a linguagem.

		Mas, estando num formato mais formal, fica difícil de entender à primeira vista. Porém, se você precisa da mais confiável fonte de informações sobre detalhes da linguagem, está no lugar certo. Contudo, não é para o uso cotidiano.

		<<<<<<< HEAD
		Uma nova versão dessa especificação é lançada todos os anos. Entre estes lançamentos, a sua última versão de esboço se encontra em <https://tc39.es/ecma262/>.
		=======
		A new specification version is released every year. Between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		Para ler sobre as mais novas funcionalidades (bleeding-edge features), incluindo as que estão em fase de padronização (chamadas também de "estágio 3"), veja as suas propostas em <https://github.com/tc39/proposals>.

Expand All		@@ -19,19 +27,32 @@ E mais, se você está desenvolvendo para browsers, há outras especificações

		- MDN (Mozilla) JavaScript Reference é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções da linguagem, métodos , etc.

		<<<<<<< HEAD
		Pode ser encontrado em <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.

		Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo: <https://google.com/search?q=MDN+parseInt> para procurar pela função `parseInt`.
		=======
		You can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.

		Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for the `parseInt` function.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		## Tabelas de compatibilidade

		JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente.

		Para verificar o suporte dessas funcionalidades entre interpretadores de JavaScript (JavaScript engines) para browsers ou para outras aplicações, veja em:

		<<<<<<< HEAD
		- <http://caniuse.com> - mostra uma tabela de compatibilidade por funcionalidade, por exemplo, para verificar quais interpretadores suportam funções de criptografia moderna: <http://caniuse.com/#feat=cryptography>.
		- <https://kangax.github.io/compat-table> - uma tabela com funcionalidades da linguagem e os interpretadores que as suportam ou não.

		Todos esses recursos são úteis no cotidiano do desenvolvedor, uma vez que eles contêm informações valiosas sobre os detalhes da linguagem, seu suporte, etc.
		=======
		- <https://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <https://caniuse.com/#feat=cryptography>.
		- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.

		All these resources are useful in real-life development, as they contain valuable information about language details, their support, etc.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		Por favor, lembre-se deles (ou desta página) quando precisar de informações específicas sobre alguma funcionalidade.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -12,8 +12,13 @@ Uma IDE carrega o projeto (que pode ter muitos arquivos), permite navegação en

		Se você ainda não tiver selecionado uma IDE, considere as seguintes opções:

		<<<<<<< HEAD
		- [Visual Studio Code](https://code.visualstudio.com/) (plataforma cruzada, livre).
		- [WebStorm](https://www.jetbrains.com/pt-br/webstorm/) (plataforma cruzada, pago).
		=======
		- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
		- [WebStorm](https://www.jetbrains.com/webstorm/) (cross-platform, paid).
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		Para Windows, há também "Visual Studio", que não deve ser confundido com "Visual Studio Code". "Visual Studio" é um editor pago e poderoso somente para Windows, bem adequado para a plataforma .NET . Uma versão gratuita é chamada [Visual Studio Community](https://visualstudio.microsoft.com/pt-br/vs/community/).

Expand All		@@ -29,17 +34,34 @@ A principal diferença entre um "editor leve" e uma "IDE", é que uma IDE trabal

		Na prática, os editores leves podem ter muitos plug-ins, incluindo analisadores de sintaxe no nível de diretório e preenchimentos automáticos, portanto não há uma limitação rígida entre um editor leve e uma IDE.

		<<<<<<< HEAD
		As seguintes opções merecem sua atenção:

		- [Atom](https://atom.io/) (plataforma cruzada, livre).
		- [Sublime Text](http://www.sublimetext.com) (plataforma cruzada, shareware).
		- [Notepad++](https://notepad-plus-plus.org/) (Windows, livre).
		- [Vim](http://www.vim.org/) e [Emacs](https://www.gnu.org/software/emacs/) também são legais se você sabe como usá-los.
		=======
		There are many options, for instance:

		- [Sublime Text](https://www.sublimetext.com/) (cross-platform, shareware).
		- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
		- [Vim](https://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		## Não vamos discutir

		Os editores nas listas acima são aqueles que eu ou os meus amigos que eu considero bons desenvolvedores têm usado por um longo tempo e estão felizes com eles.

		Há outros grandes editores no nosso grande mundo. Por favor, escolha o que você mais gosta.

		<<<<<<< HEAD
		A escolha de um editor, como qualquer outra ferramenta, é individual e depende de seus projetos, hábitos e preferências pessoais.
		=======
		The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.

		The author's personal opinion:

		- I'd use [Visual Studio Code](https://code.visualstudio.com/) if I develop mostly frontend.
		- Otherwise, if it's mostly another language/platform and partially frontend, then consider other editors, such as XCode (Mac), Visual Studio (Windows) or Jetbrains family (Webstorm, PHPStorm, RubyMine etc, depending on the language).
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19
Original file line number	Diff line number	Diff line change
Expand Up		@@ -22,7 +22,7 @@ As ferramentas de desenvolvedor serão abertas na aba Console por padrão.

		É parecido com isto:

		![chrome](chrome.png)
		![chrome](chrome.webp)

		O aspecto exato das ferramentas de desenvolvimento depende da sua versão do Chrome. Ele muda de vez em quando, mas deve ser semelhante.

Expand All		@@ -48,7 +48,11 @@ A interface deles é bem parecida. Uma vez que você saiba como usar uma dessas

		O Safari (navegador do Mac, não suportado pelo Windows/Linux) é um pouco especial aqui. Precisamos primeiro habilitar o "Develop menu".

		<<<<<<< HEAD
		Abra Preferências e vá para o painel "Avançado". Há uma caixa de seleção na parte inferior:
		=======
		Open Settings and go to the "Advanced" pane. There's a checkbox at the bottom:
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		![safari](safari.png)

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -12,13 +12,24 @@ const birthday = '18.04.1982';
		const age = someCode(birthday);
		```

		<<<<<<< HEAD
		Aqui temos uma constante `birthday` e a `age` que é calculada apartir de `birthday` com a ajuda de algum código (não é fornecido por falta de tempo, e porque os detalhes não importam aqui).
		=======
		Here we have a constant `birthday` for the date, and also the `age` constant.

		The `age` is calculated from `birthday` using `someCode()`, which means a function call that we didn't explain yet (we will soon!), but the details don't matter here, the point is that `age` is calculated somehow based on the `birthday`.
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19

		Seria correcto utilizar maiúsculas para `birthday`? Para `age`? Ou mesmo para ambos?

		```js
		<<<<<<< HEAD
		const BIRTHDAY = '18.04.1982'; // fazer maiúsculas?

		const AGE = someCode(BIRTHDAY); // fazer maiúsculas?
		```
		=======
		const BIRTHDAY = '18.04.1982'; // make birthday uppercase?

		const AGE = someCode(BIRTHDAY); // make age uppercase?
		>>>>>>> 51bc6d3cdc16b6eb79cb88820a58c4f037f3bf19
		```