Skip to content

Manuals and specifications #53

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Oct 22, 2019
40 changes: 40 additions & 0 deletions 1-js/01-getting-started/2-manuals-and-specifications/article.md
Original file line number Diff line number Diff line change
@@ -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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please,

  • '... detalhadas, e formalizadas...'

Copy link
Contributor Author

@Mr-Saxobeat Mr-Saxobeat Oct 18, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think there is no comma here. See these examples:

As these examples show, the last term is preceded by an "e" conective without comma.


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 <https://tc39.es/ecma262/>.

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 <https://github.com/tc39/proposals>.

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 <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`.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please,

  • '... por exemplo, ...' (would you remove this comma at the end?)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi,
I inserted a colon to indicate the example that follows, ok?

- **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: <http://msdn.microsoft.com/>.

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:

- <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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please,

  • '... funcionalidades da linguagem, e os interpretadores ...'

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Like the examples from my comment above, I think there is no comma here.

Thanks for your review :D


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.