Translate es6 of docs section into Japanese #948

sotayamashita · 2016-10-10T13:42:43Z

Japanese Translation Note

以下のことばで統一しています:

~~shipping -> リリース状態~~
~~staged -> 待機状態~~
~~in progress -> 開発状態~~
V8 or V8 engine -> V8
default -> 標準

Please review it 🙇
Thanks in advance

Update: 12/08

shipping -> リリース済み
staged -> ステージング
in progress -> 開発中
runtime flag -> ランタイムフラグ

hiroppy · 2016-10-10T13:54:29Z

cc: @nodejs/nodejs-ja

tgfjt · 2016-10-11T00:45:02Z

locale/ja/docs/es6.md

+# ECMAScript 2015 (ES6) とそれ以降のバージョン
+
+<!-- Node.js is built against modern versions of [V8](https://developers.google.com/v8/). By keeping up-to-date with the latest releases of this engine, we ensure new features from the [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) which are brought to Node.js developers in a timely manner, as well as continued performance and stability improvements. -->
+Node.js はモダンな V8 のバージョンに対して開発されました。V8 の最新のリリースに追従するには、良いタイミングで Node.js によってもちこまれた [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) の新しい機能を保証するのと同時にパフォーマンスと安定的な改善を行う必要があります。


開発されました だと過去っぽくも見えるので、開発されています はどうでしょう？

ありがとうございます。開発されました -> 開発されていますに修正しました。

tgfjt · 2016-10-11T00:58:43Z

locale/ja/docs/es6.md

+Node.js はモダンな V8 のバージョンに対して開発されました。V8 の最新のリリースに追従するには、良いタイミングで Node.js によってもちこまれた [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) の新しい機能を保証するのと同時にパフォーマンスと安定的な改善を行う必要があります。
+
+<!-- All ECMAScript 2015 (ES6) features are split into three groups for **shipping**, **staged**, and **in progress** features: -->
+すべての ECMAScript 2015 (ES6) の機能は **shipping（リリース状態）**、 **staged（待機状態）** と **in progress（開発状態）**　の3つに分けれられます：


typo 👅 分けれられます

タイポ修正しました。ありがとうございます

tgfjt · 2016-10-11T01:03:02Z

locale/ja/docs/es6.md

+* **Staged** features, which are almost-completed features that are not considered stable by the V8 team, require a runtime flag: `--harmony`.
+* **In progress** features can be activated individually by their respective harmony flag, although this is highly discouraged unless for testing purposes. Note: these flags are exposed by V8 and will potentially change without any deprecation notice. -->
+* すべての V8 で安定している **shipping（リリース状態）**の機能は**標準で有効**になってて、実行時にフラグを立てる**必要はありません**。
+* V8 チームによって安定ではないと考えられている完成間近の **staged（待機状態）** の機能には実行時に `--harmoney` が必要になります。


✕ --harmoney
◯ --harmony

タイポ修正しました。ありがとうございます

tgfjt · 2016-10-11T01:06:09Z

locale/ja/docs/es6.md

+## インフラ側で --harmony フラグを使うように設定しているんですが、フラグを除くべきですか？
+
+<!-- The current behaviour of the `--harmony` flag on Node.js is to enable **staged** features only. After all, it is now a synonym of `--es_staging`. As mentioned above, these are completed features that have not been considered stable yet. If you want to play safe, especially on production environments, consider removing this runtime flag until it ships by default on V8 and, consequently, on Node.js. If you keep this enabled, you should be prepared for further Node.js upgrades to break your code if V8 changes their semantics to more closely follow the standard. -->
+現在の Node.js での `--harmoney` フラグの挙動は  **staged（待機状態）**　のものを有効にするだけです。なので結局、`--se_staging` フラグと同意です。上記で書かれている通り、これらの機能は安定的なものではありません。もし安全に使いたいのであれば、特に本番環境で、V8 でその機能が標準になりその結果 Node.js でも標準になるまで実行フラグを除くことを考えてください。もしフラグを有効にし続けるのなら V8 がスタンダードに追従するために標準化された方法を変更するなら、 Node.js のアップグレードのためにコードを変更する準備が必要になります。


✕ --harmoney
◯ --harmony

✕ --se_staging
◯ --es_staging

なら が２回続くのどうしても気になってしまうのですがどうですか？

もしフラグを有効にし続けるのなら V8 がスタンダードに追従するために標準化された方法を変更するなら、 Node.js のアップグレードのためにコードを変更する準備が必要になります

もし出来たら言い換えることって可能ですか 🙏

タイポと なら が２回連続で続いているものを修正

tgfjt · 2016-10-13T06:23:32Z

locale/ja/docs/es6.md

+## インフラ側で --harmony フラグを使うように設定しているんですが、フラグを除くべきですか？
+
+<!-- The current behaviour of the `--harmony` flag on Node.js is to enable **staged** features only. After all, it is now a synonym of `--es_staging`. As mentioned above, these are completed features that have not been considered stable yet. If you want to play safe, especially on production environments, consider removing this runtime flag until it ships by default on V8 and, consequently, on Node.js. If you keep this enabled, you should be prepared for further Node.js upgrades to break your code if V8 changes their semantics to more closely follow the standard. -->
+現在の Node.js での `--harmony` フラグの挙動は  **staged（待機状態）**　のものを有効にするだけです。なので結局、`--es_staging` フラグと同意です。上記で書かれている通り、これらの機能は安定的なものではありません。もし安全に使いたいのであれば、特に本番環境で、V8 でその機能が標準になりその結果 Node.js でも標準になるまで実行フラグを除くことを考えてください。もしフラグを有効にし続けるのなら V8 がスタンダードに追従するために標準化された方法を変更する際に Node.js のアップグレードのためにコードを変更する準備が必要になります。


V8 がスタンダードに追従するために標準化された方法を変更する際

なんていうんですかね…ここの日本語をもう少し分かりやすくしたいのですが

ここも長くて大変ですね。。参考までに自分なりに考えてみました！いかがでしょう？

現在の Node.js での --harmony フラグの挙動は staged（待機状態）　のものを有効にするだけのものです。つまるところ、--es_staging フラグと同じ意味となります。前述の通り、安定していない機能も含んでいます。本番環境などで安定して Node.js を使いたい場合は、V8 で該当の機能が標準となり、その結果 Node.js でも標準になるまで実行フラグを除くことを検討してください。このフラグを継続的に利用する場合は、Node.js の更新の際に、標準への追随などのために更新される V8 の挙動によってコードが動作しなくなる可能性を考慮して対策をするようにすることを推奨します。

@tgfjt
すいません。もう少し精度上げていきます。その後一度マージしていただいて早いスピードで改善していければと思っています。

@watilde
ありがとうございます。参考になります 🙇

watilde · 2016-10-13T20:53:38Z

@sotayamashita 長いセクションの翻訳ほんとにお疲れ様です！いま全部読んでみましたが、英語っぽい表現が多くてなかなか骨が折れますねここ；　一通りコメントしましたが、ちょっと違和感あるっていうのとかあったら気軽にコメントください！引き続きよろしくお願いします😃

watilde · 2016-10-13T20:26:38Z

locale/ja/docs/es6.md

+# ECMAScript 2015 (ES6) とそれ以降のバージョン
+
+<!-- Node.js is built against modern versions of [V8](https://developers.google.com/v8/). By keeping up-to-date with the latest releases of this engine, we ensure new features from the [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) which are brought to Node.js developers in a timely manner, as well as continued performance and stability improvements. -->
+Node.js はモダンな V8 のバージョンに対して開発されています。V8 の最新のリリースに追従するには、良いタイミングで Node.js によってもちこまれた [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) の新しい機能を保証するのと同時にパフォーマンスと安定的な改善を行う必要があります。


ここも英語っぽい表現で翻訳むずかしいですね。。後半、こういう感じでどうでしょう？

継続的なパフォーマンス及び安定性の向上と、JavaScript ECMA-262 specification の新しい機能をタイムリーに追加するために私たちはそれらの動作の保証を行います。

watilde · 2016-10-13T20:30:55Z

locale/ja/docs/es6.md

+* **In progress** features can be activated individually by their respective harmony flag, although this is highly discouraged unless for testing purposes. Note: these flags are exposed by V8 and will potentially change without any deprecation notice. -->
+* すべての V8 で安定している **shipping（リリース状態）**の機能は**標準で有効**になってて、実行時にフラグを立てる**必要はありません**。
+* V8 チームによって安定ではないと考えられている完成間近の **staged（待機状態）** の機能には実行時に `--harmony` が必要になります。
+* **In progress（開発状態）**の機能はそれぞれのハーモニーフラグで有効にすることができますが、テスト目的以外では非推奨です。注意：これらのフラグは、V8によって公開され、予告なしに変更される可能性があります。


細かいですが、時制と表現をちょっとだけ

+ これらのフラグは、V8 によって提供されており、将来的に予告なしに変更される可能性があります。 - 注意：これらのフラグは、V8によって公開され、予告なしに変更される可能性があります。

@watilde ありがとうございます。コメントで頂いた文章に他の揃えるために 注意 と付けて修正しました。

watilde · 2016-10-13T20:45:43Z

locale/ja/docs/es6.md

+## インフラ側で --harmony フラグを使うように設定しているんですが、フラグを除くべきですか？
+
+<!-- The current behaviour of the `--harmony` flag on Node.js is to enable **staged** features only. After all, it is now a synonym of `--es_staging`. As mentioned above, these are completed features that have not been considered stable yet. If you want to play safe, especially on production environments, consider removing this runtime flag until it ships by default on V8 and, consequently, on Node.js. If you keep this enabled, you should be prepared for further Node.js upgrades to break your code if V8 changes their semantics to more closely follow the standard. -->
+現在の Node.js での `--harmony` フラグの挙動は  **staged（待機状態）**　のものを有効にするだけです。なので結局、`--es_staging` フラグと同意です。上記で書かれている通り、これらの機能は安定的なものではありません。もし安全に使いたいのであれば、特に本番環境で、V8 でその機能が標準になりその結果 Node.js でも標準になるまで実行フラグを除くことを考えてください。もしフラグを有効にし続けるのなら V8 がスタンダードに追従するために標準化された方法を変更する際に Node.js のアップグレードのためにコードを変更する準備が必要になります。


ここも長くて大変ですね。。参考までに自分なりに考えてみました！いかがでしょう？

現在の Node.js での --harmony フラグの挙動は staged（待機状態）　のものを有効にするだけのものです。つまるところ、--es_staging フラグと同じ意味となります。前述の通り、安定していない機能も含んでいます。本番環境などで安定して Node.js を使いたい場合は、V8 で該当の機能が標準となり、その結果 Node.js でも標準になるまで実行フラグを除くことを検討してください。このフラグを継続的に利用する場合は、Node.js の更新の際に、標準への追随などのために更新される V8 の挙動によってコードが動作しなくなる可能性を考慮して対策をするようにすることを推奨します。

watilde · 2016-10-13T20:49:48Z

locale/ja/docs/es6.md

+## どのようにすればリリースされた Node.js のバージョンごとに組み込まれている V8 のバージョンを確認できますか？
+
+<!-- Node.js provides a simple way to list all dependencies and respective versions that ship with a specific binary through the `process` global object. In case of the V8 engine, type the following in your terminal to retrieve its version: -->
+Node.js はすべての依存しているものと `process` というグローバルなオブジェクトを通して特定のバイナリー含んだリリースのそれぞれのバージョンを列挙する簡単な方法を提供しています。V8 に関しては、以下のコマンドを実行することでそのバージョンを取得することができます：


ここは、文章の順番を変えるとそれっぽくなる気がします！

Node.js では、すべての依存ライブラリとそのバージョンを一覧する `process` というグローバルオブジェクトを提供しています。例えば V8 の情報について知りたい場合は、下記のコマンドを実行することでバージョンが表示されます。

@watilde ありがとうございます。この部分コメント頂いたものを組み合わせて以下のように修正しました。

Node.js では、すべての依存ライブラリとそのバージョンを列挙する `process` というグローバルオブジェクトを提供しています。例えば V8 の情報について知りたい場合は、下記のコマンドを実行することでバージョンが表示されます：

sotayamashita · 2016-10-23T04:09:49Z

@watilde @tgfjt
コメント頂いた部分を修正しました。お手すきの際に確認お願いします。

tgfjt · 2016-10-23T10:17:56Z

locale/ja/docs/es6.md

+<!-- * All **shipping** features, which V8 considers stable, are turned **on by default on Node.js** and do **NOT** require any kind of runtime flag.
+* **Staged** features, which are almost-completed features that are not considered stable by the V8 team, require a runtime flag: `--harmony`.
+* **In progress** features can be activated individually by their respective harmony flag, although this is highly discouraged unless for testing purposes. Note: these flags are exposed by V8 and will potentially change without any deprecation notice. -->
+* すべての V8 で安定している **shipping（リリース状態）**の機能は**標準で有効**になってて、実行時にフラグを立てる**必要はありません**。


なってて だと少しフランクな感じがするので、なっており はどうでしょう ❓

@tgfjt ありがとうございます修正しました

sotayamashita · 2016-11-15T00:02:29Z

お手すきの際に確認お願いします @tgfjt @watilde

tgfjt · 2016-11-15T00:25:23Z

locale/ja/docs/es6.md

+新しい機能は定期的に V8 に追加されています。一般的に、これらの機能は Node.js の未来のリリースで有効になることが期待されますが時期は未定です。
+
+<!-- You may list all the *in progress* features available on each Node.js release by grepping through the `--v8-options` argument. Please note that these are incomplete and possibly broken features of V8, so use them at your own risk: -->
+`--v8-options` をオプションを指定した実行結果を `grep "in progress"` することで、それぞれの Node.js のリリースごで使用できるすべてのin progress（開発状態）の機能を列挙することができます。ここで注意してほしいのが、これらの機能は完全ではないので V8 では実行不可能な機能かもしれませんので、使用する際は自己責任になります：


リリースごで → リリース毎に でしょうかね？？

tgfjt · 2016-11-15T00:28:47Z

locale/ja/docs/es6.md

+新しい機能は定期的に V8 に追加されています。一般的に、これらの機能は Node.js の未来のリリースで有効になることが期待されますが時期は未定です。
+
+<!-- You may list all the *in progress* features available on each Node.js release by grepping through the `--v8-options` argument. Please note that these are incomplete and possibly broken features of V8, so use them at your own risk: -->
+`--v8-options` をオプションを指定した実行結果を `grep "in progress"` することで、それぞれの Node.js のリリースごで使用できるすべてのin progress（開発状態）の機能を列挙することができます。ここで注意してほしいのが、これらの機能は完全ではないので V8 では実行不可能な機能かもしれませんので、使用する際は自己責任になります：


これらの機能は完全ではないので V8 では実行不可能な機能かもしれませんので

〜ので〜ので よりは、これらは完全ではなく、 V8 では動かない可能性もありますので くらいでどうでしょう？？？

tgfjt · 2016-11-15T00:32:09Z

@sotayamashita
すみません、別のところが今更気になってしまいました！

sotayamashita · 2016-11-15T01:51:07Z

@tgfjt とんでもないです。ありがとうございます 🙇 改めて修正します

e-jigsaw · 2016-11-17T09:06:12Z

locale/ja/docs/es6.md

@@ -31,7 +31,8 @@ Kangax 氏の ECMAScript の機能互換性テーブルをもとにした [node.
 新しい機能は定期的に V8 に追加されています。一般的に、これらの機能は Node.js の未来のリリースで有効になることが期待されますが時期は未定です。

 <!-- You may list all the *in progress* features available on each Node.js release by grepping through the `--v8-options` argument. Please note that these are incomplete and possibly broken features of V8, so use them at your own risk: -->
-`--v8-options` をオプションを指定した実行結果を `grep "in progress"` することで、それぞれの Node.js のリリースごで使用できるすべてのin progress（開発状態）の機能を列挙することができます。ここで注意してほしいのが、これらの機能は完全ではないので V8 では実行不可能な機能かもしれませんので、使用する際は自己責任になります：
+`--v8-options` をオプションを指定した実行結果を `grep "in progress"` することで、それぞれの Node.js のリリースごとに使用できるすべての in progress（開発状態）の機能を列挙することができます。ここで注意してほしいのが、
+これらの機能あ完全ではなく、V8 では動かない可能性があるので使用する際は自己責任になります：


これらの機能あ

typo

ありがとうございます。今見直しています。

sotayamashita · 2016-12-08T07:01:54Z

Hi @nodejs/nodejs-ja
If there are not fatal mistakes, please merge it. 🙇

okuryu · 2016-12-08T11:32:12Z

+1

tgfjt · 2016-12-08T12:33:11Z

👍

watilde · 2016-12-08T13:12:50Z

I just chat to Sota to do squash/rebase the commits together :)

Fix the frequency aggregation of words Modify small Japanese expression Modify small Japanese expression Modify small Japanese expression Update translate Improve Japanese tranlsation Fix space between words

watilde · 2016-12-10T11:32:44Z

Thanks for rebasing and squash the commits! Let's 🐑 it.

hiroppy added i18n Issues/PRs related to the Website Internationalisation needs WG +1 labels Oct 10, 2016

tgfjt reviewed Oct 11, 2016

View reviewed changes

hiroppy removed needs i18n +1 labels Oct 11, 2016

tgfjt reviewed Oct 13, 2016

View reviewed changes

watilde reviewed Oct 13, 2016

View reviewed changes

tgfjt reviewed Oct 23, 2016

View reviewed changes

tgfjt reviewed Nov 15, 2016

View reviewed changes

e-jigsaw reviewed Nov 17, 2016

View reviewed changes

nodejs-ja: Add file - es6.md

40c1ff5

Fix the frequency aggregation of words Modify small Japanese expression Modify small Japanese expression Modify small Japanese expression Update translate Improve Japanese tranlsation Fix space between words

sotayamashita force-pushed the translate/ja-docs-es6 branch from b049fa0 to 40c1ff5 Compare December 10, 2016 07:36

watilde merged commit 1820673 into nodejs:master Dec 10, 2016

sotayamashita deleted the translate/ja-docs-es6 branch December 19, 2016 05:39

This was referenced Jan 22, 2020

[Snyk] Fix for 1 vulnerabilities bryanweast/nodejs.org#6

Open

[Snyk] Fix for 2 vulnerabilities bryanweast/nodejs.org#8

Open

Translate es6 of docs section into Japanese #948

Translate es6 of docs section into Japanese #948

Conversation

sotayamashita commented Oct 10, 2016 • edited Loading

Japanese Translation Note

hiroppy commented Oct 10, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

hiroppy Oct 11, 2016 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

watilde commented Oct 13, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sotayamashita Oct 23, 2016 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sotayamashita commented Oct 23, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sotayamashita commented Nov 15, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

tgfjt commented Nov 15, 2016

sotayamashita commented Nov 15, 2016

Choose a reason for hiding this comment

sotayamashita Nov 17, 2016 • edited Loading

Choose a reason for hiding this comment

sotayamashita commented Dec 8, 2016 • edited Loading

okuryu commented Dec 8, 2016

tgfjt commented Dec 8, 2016

watilde commented Dec 8, 2016 • edited Loading

watilde commented Dec 10, 2016

sotayamashita commented Oct 10, 2016 •

edited

Loading

hiroppy Oct 11, 2016 •

edited

Loading

sotayamashita Oct 23, 2016 •

edited

Loading

sotayamashita Nov 17, 2016 •

edited

Loading

sotayamashita commented Dec 8, 2016 •

edited

Loading

watilde commented Dec 8, 2016 •

edited

Loading