Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
odsantos merged 13 commits intojavascript-tutorial:masterfromMr-Saxobeat:manuals-and-specs
Oct 22, 2019
Merged

Manuals and specifications#53

odsantos merged 13 commits intojavascript-tutorial:masterfromMr-Saxobeat:manuals-and-specs
Oct 22, 2019

Conversation

Mr-Saxobeat
Copy link
Contributor

No description provided.

@CLAassistant
Copy link

CLAassistant commentedSep 9, 2019•
edited
Loading

CLA assistant check
All committers have signed the CLA.

@Mr-SaxobeatMr-Saxobeat changed the title Manuals and specificationsManuals and specificationsSep 19, 2019
Copy link
Contributor

@odsantosodsantos left a comment

Choose a reason for hiding this comment

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

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

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

@odsantos
Copy link
Contributor

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
Copy link
ContributorAuthor

@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
Copy link
ContributorAuthor

/done

Copy link
Contributor

@odsantosodsantos left a comment

Choose a reason for hiding this comment

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

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

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
Copy link
ContributorAuthor

/done

Copy link
Contributor

@odsantosodsantos left a comment

Choose a reason for hiding this comment

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

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.


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

@Mr-SaxobeatMr-SaxobeatOct 18, 2019•
edited
Loading

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.


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

Choose a reason for hiding this comment

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

Please,

  • 'Mas, estando num formato mais formal, ...'
  • 'Mas, não é para o uso cotidiano.'

Copy link
ContributorAuthor

Choose a reason for hiding this comment

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

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


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

Choose a reason for hiding this comment

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

Please,

  • 'MDN (Mozilla) JavaScript Reference, é um manual ...'
  • '... entendimento sobre funções, métodos da linguagem, etc.

Copy link
ContributorAuthor

Choose a reason for hiding this comment

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

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

Copy link
ContributorAuthor

@Mr-SaxobeatMr-SaxobeatOct 18, 2019•
edited
Loading

Choose a reason for hiding this comment

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

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


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

Choose a reason for hiding this comment

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

Please,

  • 'Assim comono para o manual da Mozilla, ...'
  • '... do tipo "RegExp MSDN", ou "RegExp MSDN jscript".'

Copy link
ContributorAuthor

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 before the "ou" conective. I found examples here:

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

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

@javascript-translate-bot

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

@Mr-Saxobeat
Copy link
ContributorAuthor

/done

Copy link
Contributor

@odsantosodsantos left a comment

Choose a reason for hiding this comment

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

Hi,

Would you please consider these changes?

Thanks.

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
ContributorAuthor

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?

@javascript-translate-bot

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

@Mr-Saxobeat
Copy link
ContributorAuthor

/done

@odsantos
Copy link
Contributor

@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
Copy link
ContributorAuthor

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

@odsantos
Copy link
Contributor

@Mr-Saxobeat Thank you. Regards.

Copy link
Contributor

@odsantosodsantos left a comment

Choose a reason for hiding this comment

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

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.

@odsantosodsantos merged commit58e2eb0 intojavascript-tutorial:masterOct 22, 2019
@javascript-translate-bot

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

Mr-Saxobeat reacted with hooray emoji

@Mr-Saxobeat
Copy link
ContributorAuthor

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

@odsantos, I did right now

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment

Reviewers

@odsantosodsantosodsantos approved these changes

Assignees

No one assigned

Labels

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@Mr-Saxobeat@CLAassistant@javascript-translate-bot@odsantos
[8]ページ先頭
©2009-2025 Movatter.jp