Visitar URL original
Manuals and specifications by Mr-Saxobeat · Pull Request #53 · javascript-tutorial/pt.javascript.info · GitHub
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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.

Comment thread
Mr-Saxobeat marked this conversation as resolved.
## 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
Copy Markdown
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...'

@Mr-Saxobeat Mr-Saxobeat Oct 18, 2019 •

Copy link
Copy Markdown
Contributor Author

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
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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.