From cea2e97aebe13daa96679d04e044f086ab678b85 Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 9 Sep 2019 10:26:00 -0300 Subject: [PATCH 01/13] create manuals-and-specs section Reorganize folders from chapter 1 and add the "Manuals and specifications" article. --- .../2-manuals-and-specifications/article.md | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 1-js/01-getting-started/2-manuals-and-specifications/article.md diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md new file mode 100644 index 000000000..cea49cf79 --- /dev/null +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -0,0 +1,43 @@ +# Manuais e especificações + +Este site é um *tutorial* que vai te ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. + +## Especificações + +A **Especificação ECMA-262** contém as mais profundas, detalhadas e formalizadas informações sobre o JavaScript. Ela que define a linguagem. + +Mas sendo num formato mais formal, fica difícil de entender a primeira vista. Então se você precisa de uma fonte de informação confiável sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. + +Sua última versão se encontra em . + +Para ler sobre as mais novas funcionalidades (conhecidas como bleeding-edge features), que estão em fase de padronização, veja suas propostas em . + +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. + +## Manuais + +- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções e métodos da linguagem, etc. + + Pode ser encontrado em . + + Porém, as vezes é melhor fazer uma busca na internet. Apenas use “MDN [termo]” na busca, e.g. . + +- **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, melhor ir por aqui: . + + Assim como no manual do Mozilla, também podemos fazer uma busca na internet com frases do tipo “RegExp MSDN” ou “RegExp MSDN jscript”. + +## Suporte à funcionalidades + +JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. + +Para verificar o suporte à essas funcionalidades em browsers e em outras engines, veja em: + +- - mostra uma tabela de suporte, e.g, para varificar quais engines suportam funções de criptografia moderna: . +- - uma tabela com as funcionalidades da linguagem e as engines que a suportam ou não. + +Todos esses recursos são úteis no cotidiano do desenvolvedor, uma vez que eles contêm informações valiosas sobre a linguagem, detalhes, seus suportes, etc. + +Guarde bem essas páginas (ou esta aqui mesmo) para caso você precise de informações específicas de alguma funcionalidade. + + + From 0be9769bb89f241ec565a18e7475d6566cc7120c Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 9 Sep 2019 10:27:13 -0300 Subject: [PATCH 02/13] Renumber article folders --- .../{2-code-editors => 3-code-editors}/article.md | 0 .../{3-devtools => 4-devtools}/article.md | 0 .../{3-devtools => 4-devtools}/bug.html | 0 .../{3-devtools => 4-devtools}/chrome.png | Bin .../{3-devtools => 4-devtools}/chrome@2x.png | Bin .../{3-devtools => 4-devtools}/safari.png | Bin .../{3-devtools => 4-devtools}/safari@2x.png | Bin 7 files changed, 0 insertions(+), 0 deletions(-) rename 1-js/01-getting-started/{2-code-editors => 3-code-editors}/article.md (100%) rename 1-js/01-getting-started/{3-devtools => 4-devtools}/article.md (100%) rename 1-js/01-getting-started/{3-devtools => 4-devtools}/bug.html (100%) rename 1-js/01-getting-started/{3-devtools => 4-devtools}/chrome.png (100%) rename 1-js/01-getting-started/{3-devtools => 4-devtools}/chrome@2x.png (100%) rename 1-js/01-getting-started/{3-devtools => 4-devtools}/safari.png (100%) rename 1-js/01-getting-started/{3-devtools => 4-devtools}/safari@2x.png (100%) diff --git a/1-js/01-getting-started/2-code-editors/article.md b/1-js/01-getting-started/3-code-editors/article.md similarity index 100% rename from 1-js/01-getting-started/2-code-editors/article.md rename to 1-js/01-getting-started/3-code-editors/article.md diff --git a/1-js/01-getting-started/3-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md similarity index 100% rename from 1-js/01-getting-started/3-devtools/article.md rename to 1-js/01-getting-started/4-devtools/article.md diff --git a/1-js/01-getting-started/3-devtools/bug.html b/1-js/01-getting-started/4-devtools/bug.html similarity index 100% rename from 1-js/01-getting-started/3-devtools/bug.html rename to 1-js/01-getting-started/4-devtools/bug.html diff --git a/1-js/01-getting-started/3-devtools/chrome.png b/1-js/01-getting-started/4-devtools/chrome.png similarity index 100% rename from 1-js/01-getting-started/3-devtools/chrome.png rename to 1-js/01-getting-started/4-devtools/chrome.png diff --git a/1-js/01-getting-started/3-devtools/chrome@2x.png b/1-js/01-getting-started/4-devtools/chrome@2x.png similarity index 100% rename from 1-js/01-getting-started/3-devtools/chrome@2x.png rename to 1-js/01-getting-started/4-devtools/chrome@2x.png diff --git a/1-js/01-getting-started/3-devtools/safari.png b/1-js/01-getting-started/4-devtools/safari.png similarity index 100% rename from 1-js/01-getting-started/3-devtools/safari.png rename to 1-js/01-getting-started/4-devtools/safari.png diff --git a/1-js/01-getting-started/3-devtools/safari@2x.png b/1-js/01-getting-started/4-devtools/safari@2x.png similarity index 100% rename from 1-js/01-getting-started/3-devtools/safari@2x.png rename to 1-js/01-getting-started/4-devtools/safari@2x.png From 06dfb8e38ece36f98d2089db4880f34bc00ecb6a Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 9 Sep 2019 10:33:53 -0300 Subject: [PATCH 03/13] Fix formats, links and grammar --- .../2-manuals-and-specifications/article.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index cea49cf79..9aaeaebe5 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -4,11 +4,11 @@ Este site ## Especificações -A **Especificação ECMA-262** contém as mais profundas, detalhadas e formalizadas informações sobre o JavaScript. Ela que define a linguagem. +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 o JavaScript. Ela que define a linguagem. Mas sendo num formato mais formal, fica difícil de entender a primeira vista. Então se você precisa de uma fonte de informação confiável sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. -Sua última versão se encontra em . +Uma nova versão dessa especificação é lançada todo ano. Sua última versão se encontra em . Para ler sobre as mais novas funcionalidades (conhecidas como bleeding-edge features), que estão em fase de padronização, veja suas propostas em . @@ -26,13 +26,13 @@ E mais, se voc Assim como no manual do Mozilla, também podemos fazer uma busca na internet com frases do tipo “RegExp MSDN” ou “RegExp MSDN jscript”. -## Suporte à funcionalidades +## Tabelas de compatibilidade JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. -Para verificar o suporte à essas funcionalidades em browsers e em outras engines, veja em: +Para verificar a compatibilidade dessas funcionalidades em browsers e em outras engines, veja em: -- - mostra uma tabela de suporte, e.g, para varificar quais engines suportam funções de criptografia moderna: . +- - mostra uma tabela de compatibilidade, e.g, para varificar quais engines suportam funções de criptografia moderna: . - - uma tabela com as funcionalidades da linguagem e as engines que a suportam ou não. Todos esses recursos são úteis no cotidiano do desenvolvedor, uma vez que eles contêm informações valiosas sobre a linguagem, detalhes, seus suportes, etc. From d36a94b317671e381f6c42f359e30293682f375a Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 9 Sep 2019 10:35:08 -0300 Subject: [PATCH 04/13] Remove wrong hiperlink --- 1-js/01-getting-started/2-manuals-and-specifications/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 9aaeaebe5..9d024a31c 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -12,7 +12,7 @@ Uma nova vers Para ler sobre as mais novas funcionalidades (conhecidas como bleeding-edge features), que estão em fase de padronização, veja suas propostas em . -E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na segunda parte do tutorial. ## Manuais From 1f2175810ad8997a812d284933694b35f0ea66ac Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 9 Sep 2019 10:37:16 -0300 Subject: [PATCH 05/13] Fix hiperlink and programming expression format --- 1-js/01-getting-started/2-manuals-and-specifications/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 9d024a31c..145d12ccc 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -20,7 +20,7 @@ E mais, se voc Pode ser encontrado em . - Porém, as vezes é melhor fazer uma busca na internet. Apenas use “MDN [termo]” na busca, e.g. . + Porém, as vezes é melhor fazer uma busca na internet. Apenas use “MDN [termo]” na busca, e.g. para procurar pela função `parseInt`. - **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, melhor ir por aqui: . From 25761e6225eafb9ad9784bc42dd91dc7ca71a135 Mon Sep 17 00:00:00 2001 From: Weiglas Date: Tue, 24 Sep 2019 11:33:33 -0300 Subject: [PATCH 06/13] Make some changes requested --- .../2-manuals-and-specifications/article.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 145d12ccc..8a7e46d58 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -1,18 +1,18 @@ -# Manuais e especificações +# Manuais e especificação -Este site é um *tutorial* que vai te ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. +Este site é um *tutorial*. Ele tem com objetivo lhe ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. ## Especificações -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 o JavaScript. Ela que define a linguagem. +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 o JavaScript. Ela define a linguagem. -Mas sendo num formato mais formal, fica difícil de entender a primeira vista. Então se você precisa de uma fonte de informação confiável sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. +Mas sendo num formato mais formal, fica difícil de entender à primeira vista. Então se você precisa de uma fonte de informação mais confiável sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. -Uma nova versão dessa especificação é lançada todo ano. Sua última versão se encontra em . +Uma nova versão dessa especificação é lançada todos os ano. Entre estes lançamentos, a sua última versão se encontra em . -Para ler sobre as mais novas funcionalidades (conhecidas como bleeding-edge features), que estão em fase de padronização, veja suas propostas em . +Para ler sobre as mais novas funcionalidades (*bleeding-edge features*, também chamada de "estágio 3"), que estão em fase de padronização, veja suas propostas em . -E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na segunda parte do tutorial. +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. ## Manuais From e1a16543aee6996e3ca6659adf7ad756626fda66 Mon Sep 17 00:00:00 2001 From: Weiglas Date: Tue, 24 Sep 2019 12:05:00 -0300 Subject: [PATCH 07/13] Finish requested changes --- .../2-manuals-and-specifications/article.md | 31 +++++++++---------- 1 file changed, 14 insertions(+), 17 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 8a7e46d58..04d0016b9 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -1,16 +1,16 @@ -# Manuais e especificação +# Manuais e especificações -Este site é um *tutorial*. Ele tem com objetivo lhe ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. +Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. -## Especificações +## 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 o JavaScript. Ela define a linguagem. -Mas sendo num formato mais formal, fica difícil de entender à primeira vista. Então se você precisa de uma fonte de informação mais confiável sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. +Mas sendo num formato mais formal, fica difícil de entender à primeira vista. Então se você precisa da mais confiável fonte de informação sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. -Uma nova versão dessa especificação é lançada todos os ano. Entre estes lançamentos, a sua última versão se encontra em . +Uma nova versão dessa especificação é lançada todos os ano. Entre estes lançamentos, a sua última versão de esboço se encontra em . -Para ler sobre as mais novas funcionalidades (*bleeding-edge features*, também chamada de "estágio 3"), que estão em fase de padronização, veja suas propostas em . +Para ler sobre as mais novas funcionalidades (*bleeding-edge features*, também chamada "de estágio 3"), que estão em fase de padronização, veja suas propostas em . E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. @@ -20,24 +20,21 @@ E mais, se voc Pode ser encontrado em . - Porém, as vezes é melhor fazer uma busca na internet. Apenas use “MDN [termo]” na busca, e.g. para procurar pela função `parseInt`. + Porém, as vezes é melhor fazer uma busca na internet. Apenas use “MDN [termo]” na busca, ex. para procurar pela função `parseInt`. -- **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, melhor ir por aqui: . +- **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, é melhor ir por aqui: . - Assim como no manual do Mozilla, também podemos fazer uma busca na internet com frases do tipo “RegExp MSDN” ou “RegExp MSDN jscript”. + Assim como no manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo “RegExp MSDN” ou “RegExp MSDN jscript”. ## Tabelas de compatibilidade JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. -Para verificar a compatibilidade dessas funcionalidades em browsers e em outras engines, veja em: - -- - mostra uma tabela de compatibilidade, e.g, para varificar quais engines suportam funções de criptografia moderna: . -- - uma tabela com as funcionalidades da linguagem e as engines que a suportam ou não. - -Todos esses recursos são úteis no cotidiano do desenvolvedor, uma vez que eles contêm informações valiosas sobre a linguagem, detalhes, seus suportes, etc. - -Guarde bem essas páginas (ou esta aqui mesmo) para caso você precise de informações específicas de alguma funcionalidade. +Para verificar o suporte dessas funcionalidades entre interpretadores em browsers ou em outras aplicações, veja em: +- - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . +- - uma tabela com as 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, detalhes, seu suporte, etc. +Por favor, lembre-se deles (ou desta página) nos casos em que precisar de informações específicas sobre alguma funcionalidade. \ No newline at end of file From cd1e4fdd1c30b66de9943d1a89d61ca287a26ce8 Mon Sep 17 00:00:00 2001 From: Weiglas Date: Fri, 27 Sep 2019 10:30:38 -0300 Subject: [PATCH 08/13] Fix broken characters When I opened the article, some characters were broken, justfixed it. --- .../2-manuals-and-specifications/article.md | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 04d0016b9..e3e291c99 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -1,40 +1,40 @@ -# Manuais e especificações +# Manuais e especificações -Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. +Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. -## Especificação +## 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 o JavaScript. Ela define a linguagem. +A [Especificacão ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contém as mais profundas, detalhadas e formalizadas informações sobre o JavaScript. Ela define a linguagem. -Mas sendo num formato mais formal, fica difícil de entender à primeira vista. Então se você precisa da mais confiável fonte de informação sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. +Mas sendo num formato mais formal, fica difécil de entender à primeira vista. Então se você precisa da mais confiável fonte de informações sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. -Uma nova versão dessa especificação é lançada todos os ano. Entre estes lançamentos, a sua última versão de esboço se encontra em . +Uma nova versão dessa especificação é lançada todos os ano. Entre estes lançamentos, a sua última versão de esboço se encontra em . -Para ler sobre as mais novas funcionalidades (*bleeding-edge features*, também chamada "de estágio 3"), que estão em fase de padronização, veja suas propostas em . +Para ler sobre as mais novas funcionalidades (*bleeding-edge features*, também chamada "de estágio 3"), que estão em fase de padronização, veja suas propostas em . -E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. ## Manuais -- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções e métodos da linguagem, etc. +- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções e métodos da linguagem, etc. Pode ser encontrado em . - Porém, as vezes é melhor fazer uma busca na internet. Apenas use “MDN [termo]” na busca, ex. para procurar pela função `parseInt`. + Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]"" na busca, ex. para procurar pela função `parseInt`. -- **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, é melhor ir por aqui: . +- **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, é melhor ir por aqui: . - Assim como no manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo “RegExp MSDN” ou “RegExp MSDN jscript”. + Assim como no manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo "RegExp MSDN" ou "RegExp MSDN jscript". ## Tabelas de compatibilidade -JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. +JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. -Para verificar o suporte dessas funcionalidades entre interpretadores em browsers ou em outras aplicações, veja em: +Para verificar o suporte dessas funcionalidades entre interpretadores em browsers ou em outras aplicações, veja em: -- - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . -- - uma tabela com as funcionalidades da linguagem e os interpretadores que as suportam ou não. +- - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . +- - uma tabela com as 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, detalhes, seu suporte, etc. +Todos esses recursos são úteis no cotidiano do desenvolvedor, uma vez que eles contém informações valiosas sobre os detalhes da linguagem, detalhes, seu suporte, etc. -Por favor, lembre-se deles (ou desta página) nos casos em que precisar de informações específicas sobre alguma funcionalidade. \ No newline at end of file +Por favor, lembre-se deles (ou desta página) nos casos em que precisar de informações específicas sobre alguma funcionalidade. From 4e94fe5ad8358981c2e1023a2128d0e60c393cec Mon Sep 17 00:00:00 2001 From: Weiglas Date: Fri, 27 Sep 2019 10:36:37 -0300 Subject: [PATCH 09/13] Make requested changes --- .../2-manuals-and-specifications/article.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index e3e291c99..6c0d851d3 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -1,16 +1,16 @@ # Manuais e especificações -Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender a linguagem gradualmente. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. +Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradualmente a linguagem. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. ## Especificação -A [Especificacão ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contém as mais profundas, detalhadas e formalizadas informações sobre o JavaScript. Ela define a linguagem. +A [Especificacã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 sendo num formato mais formal, fica difécil de entender à primeira vista. Então se você precisa da mais confiável fonte de informações sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. -Uma nova versão dessa especificação é lançada todos os ano. Entre estes lançamentos, a sua última versão de esboço se encontra em . +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 . -Para ler sobre as mais novas funcionalidades (*bleeding-edge features*, também chamada "de estágio 3"), que estão em fase de padronização, veja suas propostas em . +Para ler sobre as mais novas funcionalidades (*bleeding-edge features*), incluindo as que estão em fase de padronização (também chamadas de "estágio 3"), veja suas propostas em . E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. @@ -30,11 +30,11 @@ E mais, se você está desenvolvendo para browsers, há outras especificações JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. -Para verificar o suporte dessas funcionalidades entre interpretadores em browsers ou em outras aplicações, veja em: +Para verificar o suporte dessas funcionalidades entre interpretadores (JavaScript engines) para browsers ou para outras aplicações, veja em: - - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . - - uma tabela com as 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, detalhes, seu suporte, etc. +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. -Por favor, lembre-se deles (ou desta página) nos casos em que precisar de informações específicas sobre alguma funcionalidade. +Por favor, lembre-se deles (ou desta página) quando precisar de informações específicas sobre alguma funcionalidade. From 7be0741f01eb8a42a094c22911af0659d7073a35 Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 14 Oct 2019 11:52:14 -0300 Subject: [PATCH 10/13] Make requested changes --- .../2-manuals-and-specifications/article.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 6c0d851d3..340f4cc2c 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -6,13 +6,13 @@ Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradual A [Especificacã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 sendo num formato mais formal, fica difécil de entender à primeira vista. Então se você precisa da mais confiável fonte de informações sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. +Mas estando num formato mais formal, fica difícil de entender à primeira vista. Então se você precisa da mais confiável fonte de informações sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. 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 . Para ler sobre as mais novas funcionalidades (*bleeding-edge features*), incluindo as que estão em fase de padronização (também chamadas de "estágio 3"), veja suas propostas em . -E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] do tutorial. +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] **(what is the link it should redirect?)** do tutorial. ## Manuais @@ -30,7 +30,7 @@ E mais, se você está desenvolvendo para browsers, há outras especificações JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adicionadas regularmente. -Para verificar o suporte dessas funcionalidades entre interpretadores (JavaScript engines) para browsers ou para outras aplicações, veja em: +Para verificar o suporte dessas funcionalidades entre interpretadores de JavaScript (JavaScript engines) para browsers ou para outras aplicações, veja em: - - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . - - uma tabela com as funcionalidades da linguagem e os interpretadores que as suportam ou não. From 36633468a5d4a5cb62200f58bed8664949040f6d Mon Sep 17 00:00:00 2001 From: Weiglas Date: Tue, 15 Oct 2019 07:38:27 -0300 Subject: [PATCH 11/13] Make requested changes --- .../2-manuals-and-specifications/article.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 340f4cc2c..8b949dd33 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -6,13 +6,13 @@ Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradual A [Especificacã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. Então se você precisa da mais confiável fonte de informações sobre os detalhes da linguagem, está no lugar certo. Mas não é para o uso cotidiano. +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. Mas não é para o uso cotidiano. 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 . Para ler sobre as mais novas funcionalidades (*bleeding-edge features*), incluindo as que estão em fase de padronização (também chamadas de "estágio 3"), veja suas propostas em . -E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte] **(what is the link it should redirect?)** do tutorial. +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte](https://javascript.info/browser-environment) do tutorial. ## Manuais @@ -30,11 +30,11 @@ E mais, se você está desenvolvendo para browsers, há outras especificações 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: +Para verificar o suporte dessas funcionalidades entre interpretadores de JavaScript (*JavaScript engines*) para browsers ou para outras aplicações, veja em: - - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . -- - uma tabela com as funcionalidades da linguagem e os interpretadores que as suportam ou não. +- - 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. +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. Por favor, lembre-se deles (ou desta página) quando precisar de informações específicas sobre alguma funcionalidade. From 758fb7bb951577cf38253e1a255f251363825888 Mon Sep 17 00:00:00 2001 From: Weiglas Date: Fri, 18 Oct 2019 10:23:41 -0300 Subject: [PATCH 12/13] Make some requested changes --- .../2-manuals-and-specifications/article.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index 8b949dd33..a5d65374b 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -1,30 +1,30 @@ # Manuais e especificações -Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradualmente a linguagem. Mas uma vez que você esteja familiarizado com o básico, irá precisar de outros recursos. +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. ## Especificação A [Especificacã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. Mas não é para o uso cotidiano. +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. 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 . -Para ler sobre as mais novas funcionalidades (*bleeding-edge features*), incluindo as que estão em fase de padronização (também chamadas de "estágio 3"), veja suas propostas em . +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 suas propostas em . E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte](https://javascript.info/browser-environment) do tutorial. ## Manuais -- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções e métodos da linguagem, etc. +- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções, métodos da linguagem, etc. Pode ser encontrado em . - Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]"" na busca, ex. para procurar pela função `parseInt`. + Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo, para procurar pela função `parseInt`. - **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, é melhor ir por aqui: . - Assim como no manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo "RegExp MSDN" ou "RegExp MSDN jscript". + Assim como para o manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo "RegExp MSDN" ou "RegExp MSDN jscript". ## Tabelas de compatibilidade @@ -32,7 +32,7 @@ JavaScript é uma linguagem em desenvolvimento, novas funcionalidades são adici Para verificar o suporte dessas funcionalidades entre interpretadores de JavaScript (*JavaScript engines*) para browsers ou para outras aplicações, veja em: -- - mostra uma tabela de compatibilidade por funcionalidade, ex., para verificar quais interpretadores suportam funções de criptografia moderna: . +- - mostra uma tabela de compatibilidade por funcionalidade, por exemplo, para verificar quais interpretadores suportam funções de criptografia moderna: . - - 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. From 02795011ea774e6ee3ceb1210b029ebb7ce1f6fe Mon Sep 17 00:00:00 2001 From: Weiglas Date: Mon, 21 Oct 2019 07:48:33 -0300 Subject: [PATCH 13/13] Make requested changes --- .../2-manuals-and-specifications/article.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-and-specifications/article.md b/1-js/01-getting-started/2-manuals-and-specifications/article.md index a5d65374b..1e77bcf6c 100644 --- a/1-js/01-getting-started/2-manuals-and-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -1,6 +1,6 @@ # Manuais e especificações -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. +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. ## Especificação @@ -20,7 +20,7 @@ E mais, se você está desenvolvendo para browsers, há outras especificações Pode ser encontrado em . - Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo, para procurar pela função `parseInt`. + Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo: para procurar pela função `parseInt`. - **MSDN** - Manual da Microsoft com muitas informações, incluindo JavaScript (frequentemente referido como JScript). Se precisar de algo específico para o Internet Explorer, é melhor ir por aqui: .