Manuals and specifications #53

Mr-Saxobeat · 2019-09-09T13:40:39Z

No description provided.

Reorganize folders from chapter 1 and add the "Manuals and specifications" article.

CLAassistant · 2019-09-09T13:40:45Z

All committers have signed the CLA.

odsantos

Hi,
It is nice you're learning JavaScript.

Would you please follow these recommendations?

Try to translate as close as possible:
For instance, not 'book' for 'site'.
The title 'Specification' is in the singular form. Although, sometimes we need to change this for a more suitable translation, in this case ECMA is the specification body for JavaScript.
Try to keep the punction marks, as much as possible:
For instance, 'This book is a tutorial. It aims...';
here, there are two separate sentences.
Keep the same verb tense throught the page:
For instance, as you use 'você', change 'te ajudar' to 'lhe ajudar'...
Try to follow the context words:
For instance, in 'It defines the language.', it is the specification, so perhaps it could be
'Ela define a linguagem.'
As suggested by the site author, try to keep a general Portuguese version:
For instance, from '...é lançada todo ano.' to '...é lançada todos os anos.';
for a better comprehension, not throughout a year, but each year.

I expect to continue reviewing. Meanwhile, would you please implement these and similar changes until my possible next review, which I hope to be soon?

Thanks.

javascript-translate-bot · 2019-09-21T04:56:57Z

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

odsantos · 2019-09-22T04:53:51Z

Would you please follow these recommendations?

Try to translate as close as possible:
For instance, not 'book' for 'site'.
The title 'Specification' is in the singular form. Although, sometimes we need to change this for a more suitable translation, in this case ECMA is the specification body for JavaScript.
Try to keep the punction marks, as much as possible:
For instance, 'This book is a tutorial. It aims...';
here, there are two separate sentences.
Keep the same verb tense throught the page:
For instance, as you use 'você', change 'te ajudar' to 'lhe ajudar'...
Try to follow the context words:
For instance, in 'It defines the language.', it is the specification, so perhaps it could be
'Ela define a linguagem.'
As suggested by the site author, try to keep a general Portuguese version:
For instance, from '...é lançada todo ano.' to '...é lançada todos os anos.';
for a better comprehension, not throughout a year, but each year.
Try to keep already translated english words between parênteses in intalics (example below)
In review, passages to change:
([] - delete; {} - add, change)
- '... [site] {book translation} ...'; end sentence.
- '... [te] {lhe} ajudar ...'
- '[Especificações] {Especificação}'
- 'Ela [que] define a linguagem.'
- '... [a] {à} primeira vista.'
- '... [de uma] {da} fonte de informação {mais} confiável ...'
- '... lançada todo{s} {os} ano{s}.'
- '{Entre estes lançamentos, a } [Sua] {sua} última versão {de esboço} se encontra ...'
- '... ([conhecidas como] {bleeding-edge features}),' (comment not to be included - words in italics)
- {translation of (so-called “stage 3”)}
- '... na {include link}segunda parte do tutorial.'
- '... “MDN [termo]” na busca, [e.g.] {ex.} ...'
- '... Internet Explorer, {é} melhor ir por aqui: ...'
- '... manual [do] {da} Mozilla, também ...'
- 'Para verificar [a compatibilidade] {o suporte} dessas funcionalidades {entre interpretadores} em browsers {ou em outras aplicações} [e em outras engines], ...'
- '... mostra uma tabela de compatibilidade {por funcionalidade}, [e.g,] {ex.} para [varificar] {verificar} [quais engines] {que interpretadores} ...'
- '... e [as engines] {interpretadores} que a{s} suportam ou não.'
- '... informações valiosas sobre [a] {detalhes da} linguagem, detalhes, {o} seu[s] suporte[s], etc.'
- '[Guarde bem essas páginas] {Por favor, lembre-se deles (ou {desta página} [esta aqui mesmo]){,} [para] {nos} caso{s} {em que precisar} [você precise] de informações específicas [de] {sobre} alguma funcionalidade.'

Thank you.

Mr-Saxobeat · 2019-09-24T15:05:38Z

@odsantos, thank your for your review.
But I have some questions:

The suggestion '... [de uma] {da} fonte de informação {mais} confiável ...' doesn't souns good in brazilian portuguese, so I take de freedom to change the order, now I think it makes more sense.
To where the link of '... na {include link}segunda parte do tutorial.' should redirect? To the article in repo? To the page?

Mr-Saxobeat · 2019-09-24T15:05:45Z

/done

odsantos

Hi,
You first translation was really good.

Would you please, consider these changes:
*Note: [ ] - delete; { } - add/change; please remove the bold, as well.

'...lhe ajudar a aprender {gradualmente} a linguagem [~~gradualmente~~].'
'...e formalizadas informações sobre [o] JavaScript.'
'...lançada todos os ano{s}.'
'...mais novas funcionalidades (bleeding-edge features{)} [~~também chamada "de estágio 3")~~], {incluindo as} que estão em fase de padronização {(também chamadas de "estágio 3")}...'
'Para verificar o suporte dessas funcionalidades entre interpretadores {(JavaScript engines) - please remove the bold here} {para} [em - I asked this before, but was wrong. Thank you.] browsers ou {para} [em - I asked this before, but was wrong. Thank you.] outras aplicações,...'
'... detalhes da linguagem, ~~detalhes,~~ seu suporte, etc.'
'... lembre-se deles (ou desta página) {quando} [~~nos casos em que~~ - I asked this before, but was wrong. Thank you.] precisar de informações ...'

Thank you.

javascript-translate-bot · 2019-09-25T22:15:21Z

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

When I opened the article, some characters were broken, justfixed it.

Mr-Saxobeat · 2019-09-27T13:38:51Z

/done

odsantos

Hi,

I answered you with regards to the link.

It is done.
However, if you could append the following changes for its improvement, I would appreciate.

In the end, I will ask you if there is anything you would like to suggest for its improvement, or if I might merge your good work.

Thank you.
Regards,
Osvaldo.

1-js/01-getting-started/2-manuals-and-specifications/article.md

odsantos · 2019-10-16T01:32:50Z

1-js/01-getting-started/2-manuals-and-specifications/article.md

+
+## 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.


Please,

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

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

Regras do uso da vírgula - Racha Cuca: The "Separação de palavras de mesma função sintática" topic;

Regras de uso da vírgula - Português: The "j" topic;

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

odsantos · 2019-10-16T01:36:13Z

1-js/01-getting-started/2-manuals-and-specifications/article.md

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


Please,

'Mas, estando num formato mais formal, ...'

'Mas, não é para o uso cotidiano.'

Here, I replaced the "mas" from the last sentence with "contudo" to avoid repetition. Is it alright?

1-js/01-getting-started/2-manuals-and-specifications/article.md

odsantos · 2019-10-16T01:43:10Z

1-js/01-getting-started/2-manuals-and-specifications/article.md

+
+## 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.


Please,

'MDN (Mozilla) JavaScript Reference, é um manual ...'

'... entendimento sobre funções, métodos da linguagem, etc.

"MDN (Mozilla) JavaScript Reference" is not a vocative. So, I think there is no comma here.

I think that "...funções e métodos da linguagem" sounds more correct because the text is saying that you can find functions of the language and methods of the language. If we separate with comma, it sounds like "... functions [of what?], methods of the language...". What do you think?

1-js/01-getting-started/2-manuals-and-specifications/article.md

odsantos · 2019-10-16T01:48:06Z

1-js/01-getting-started/2-manuals-and-specifications/article.md

+
+- **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 no manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo "RegExp MSDN" ou "RegExp MSDN jscript".


Please,

'Assim como no para o manual da Mozilla, ...'

'... do tipo "RegExp MSDN", ou "RegExp MSDN jscript".'

I think there is no comma before the "ou" conective. I found examples here:

Ou e Vírgula - Gramatigalhas: The topic 3.

1-js/01-getting-started/2-manuals-and-specifications/article.md

odsantos · 2019-10-16T01:52:29Z

1-js/01-getting-started/2-manuals-and-specifications/article.md

+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, ex., 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.


Please,

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

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

Thanks for your review :D

javascript-translate-bot · 2019-10-16T02:08:46Z

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

Mr-Saxobeat · 2019-10-18T13:24:02Z

/done

odsantos

Hi,

Would you please consider these changes?

Thanks.

odsantos · 2019-10-19T02:15:33Z

1-js/01-getting-started/2-manuals-and-specifications/article.md

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


Please,

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

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

1-js/01-getting-started/2-manuals-and-specifications/article.md

javascript-translate-bot · 2019-10-19T02:19:54Z

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

Mr-Saxobeat · 2019-10-21T10:51:11Z

/done

odsantos · 2019-10-21T23:51:51Z

@Mr-Saxobeat Hi, thank you for your translation.
Would you like to make any changes or do you mind if I approve at this stage?
Best regards.

Mr-Saxobeat · 2019-10-22T11:39:39Z

@odsantos Hi, thanks for your reviews.
I think the article is good and you can approve 👍

odsantos · 2019-10-22T23:19:25Z

@Mr-Saxobeat Thank you. Regards.

odsantos

Hi,

The only request I hadn't asked you, seems to be "... as suas propostas ...".
Besides that, I appreciate you translation for such good quality.

Thank you very much.

javascript-translate-bot · 2019-10-22T23:46:13Z

Thank you 💖 I updated the Progress Issue #1 🎉 🎉 🎉

Mr-Saxobeat · 2019-10-23T15:46:51Z

The only request I hadn't asked you, seems to be "... as suas propostas ...".

@odsantos, I did right now

Mr-Saxobeat added 5 commits September 9, 2019 10:26

create manuals-and-specs section

cea2e97

Reorganize folders from chapter 1 and add the "Manuals and specifications" article.

Renumber article folders

0be9769

Fix formats, links and grammar

06dfb8e

Remove wrong hiperlink

d36a94b

Fix hiperlink and programming expression format

1f21758

javascript-translate-bot added the review needed label Sep 9, 2019

javascript-translate-bot requested a review from a team September 9, 2019 13:40

Mr-Saxobeat changed the title ~~Manuals and specifications~~ Manuals and specifications Sep 19, 2019

Mr-Saxobeat mentioned this pull request Sep 20, 2019

Portuguese Translation Progress #1

Open

javascript-translate-bot removed the review needed label Sep 21, 2019

odsantos requested changes Sep 21, 2019

View reviewed changes

javascript-translate-bot added the changes requested label Sep 21, 2019

Mr-Saxobeat added 2 commits September 24, 2019 11:33

Make some changes requested

25761e6

Finish requested changes

e1a1654

javascript-translate-bot added review needed and removed changes requested labels Sep 24, 2019

javascript-translate-bot requested a review from a team September 24, 2019 15:05

odsantos requested changes Sep 25, 2019

View reviewed changes

javascript-translate-bot removed the review needed label Sep 25, 2019

javascript-translate-bot added the changes requested label Sep 25, 2019

Mr-Saxobeat added 2 commits September 27, 2019 10:30

Fix broken characters

cd1e4fd

When I opened the article, some characters were broken, justfixed it.

Make requested changes

4e94fe5

javascript-translate-bot removed the changes requested label Sep 27, 2019

javascript-translate-bot added review needed and removed changes requested labels Oct 15, 2019

javascript-translate-bot requested a review from a team October 15, 2019 10:56

odsantos requested changes Oct 16, 2019

View reviewed changes

javascript-translate-bot removed the review needed label Oct 16, 2019

javascript-translate-bot added the changes requested label Oct 16, 2019

Make some requested changes

758fb7b

javascript-translate-bot added review needed and removed changes requested labels Oct 18, 2019

javascript-translate-bot requested a review from a team October 18, 2019 13:24

odsantos requested changes Oct 19, 2019

View reviewed changes

javascript-translate-bot added changes requested and removed review needed labels Oct 19, 2019

Make requested changes

0279501

javascript-translate-bot added review needed and removed changes requested labels Oct 21, 2019

javascript-translate-bot requested a review from a team October 21, 2019 10:51

odsantos approved these changes Oct 22, 2019

View reviewed changes

javascript-translate-bot added needs +1 and removed review needed labels Oct 22, 2019

odsantos merged commit 58e2eb0 into javascript-tutorial:master Oct 22, 2019


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


		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.


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


		- 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 no manual da Mozilla, também podemos fazer uma busca na internet com frases do tipo "RegExp MSDN" ou "RegExp MSDN jscript".

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

Manuals and specifications #53

Manuals and specifications #53

Uh oh!

Conversation

Mr-Saxobeat commented Sep 9, 2019

Uh oh!

CLAassistant commented Sep 9, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

odsantos left a comment

Choose a reason for hiding this comment

Uh oh!

javascript-translate-bot commented Sep 21, 2019

Uh oh!

odsantos commented Sep 22, 2019

Uh oh!

Mr-Saxobeat commented Sep 24, 2019

Uh oh!

Mr-Saxobeat commented Sep 24, 2019

Uh oh!

odsantos left a comment

Choose a reason for hiding this comment

Uh oh!

javascript-translate-bot commented Sep 25, 2019

Uh oh!

Mr-Saxobeat commented Sep 27, 2019

Uh oh!

odsantos left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Mr-Saxobeat Oct 18, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Mr-Saxobeat Oct 18, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

javascript-translate-bot commented Oct 16, 2019

Uh oh!

Mr-Saxobeat commented Oct 18, 2019

Uh oh!

odsantos left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

javascript-translate-bot commented Oct 19, 2019

Uh oh!

Mr-Saxobeat commented Oct 21, 2019

Uh oh!

odsantos commented Oct 21, 2019

Uh oh!

Mr-Saxobeat commented Oct 22, 2019

Uh oh!

CLAassistant commented Sep 9, 2019 •

edited

Loading

Mr-Saxobeat Oct 18, 2019 •

edited

Loading

Mr-Saxobeat Oct 18, 2019 •

edited

Loading