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..1e77bcf6c --- /dev/null +++ b/1-js/01-getting-started/2-manuals-and-specifications/article.md @@ -0,0 +1,40 @@ +# 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. + +## 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. 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 (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, 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, 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 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 + +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: + +- - 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. + +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/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