Merge pull request #8 from ksato9700/what-are-editions

What are editions

Author: tatsuya6502

TranslationTable.md

@@ -17,6 +17,7 @@
 | allocate                       | アロケートする
 | allocation                     | アロケーション
 | allocator                      | アロケータ
+| anonymous parameter            | 無名パラメータ
 | antipattern                    | アンチパターン
 | application                    | アプリケーション
 | arity                          | アリティ
@@ -70,6 +71,7 @@
 | documentation comment          | ドキュメンテーションコメント
 | documentation test             | ドキュメンテーションテスト
 | early return                   | 早期リターン
+| edition                        | エディション
 | empty tuple                    | 空タプル
 | encode                         | エンコード
 | entry point                    | エントリポイント
@@ -215,6 +217,6 @@
 | variant                        | ヴァリアント
 | vector                         | ベクタ
 | version                        | バージョン
-| warning                        | ウォーニング
+| warning                        | 警告
 | wildcard                       | ワイルドカード
 | wrapper                        | ラッパ

src/editions/creating-a-new-project.md

@@ -1,7 +1,13 @@
+<!--
 # Creating a new project
 
 When you create a new project with Cargo, it will automatically add
 configuration for the latest edition:
+-->
+
+# 新しいプロジェクトを作成する
+
+Cargoは新たなプロジェクトを作成する際に自動で最新のエディションをコンフィギュレーションに追加します。
 
 ```console
 > cargo +nightly new foo
@@ -16,11 +22,18 @@ edition = "2018"
 [dependencies]
 ```
 
+<!--
 That `edition = "2018"` setting will configure your package to use Rust 2018.
 No more configuration needed!
 
 If you'd prefer to use an older edition, you can change the value in that
 key, for example:
+-->
+
+この `edition = "2018"` によってあなたのパッケージが Rust 2018 を利用するように設定されます。
+これ以外は必要ありません。
+
+もし、他の古いエディションを使いたい場合は、その設定の値を変更できます。例えば、
 
 ```toml
 [package]
@@ -32,4 +45,8 @@ edition = "2015"
 [dependencies]
 ```
 
+<!--
 This will build your package in Rust 2015.
+-->
+
+とすると、あなたのパッケージは Rust 2015 でビルドされます。

src/editions/index.md

@@ -1,16 +1,33 @@
+<!--
 # What are Editions?
+-->
+# エディションとは？
 
+<!--
 Rust ships releases on a six-week cycle. This means that users get a constant
 stream of new features. This is much faster than updates for other languages,
 but this also means that each update is smaller.  After a while, all of those
 tiny changes add up. But, from release to release, it can be hard to look back
 and say *"Wow, between Rust 1.10 and Rust 1.20, Rust has changed a lot!"*
+-->
 
+Rustは6週間ごとにリリースを行います。
+これにより、ユーザーは新しい機能を常に手に入れることができます。
+これは他の言語よりも速いサイクルですが、アップデートのサイズは小さくなります。
+しばらくするとこれらの小変更が積み重なってきますが、いくつかのリリースを振り返って、「おお、バージョン1.10から1.20の間にRustは大きく変わったなぁ」と言うのは難しいかも知れません。
+
+<!--
 Every two or three years, we'll be producing a new *edition* of Rust. Each
 edition brings together the features that have landed into a clear package, with
 fully updated documentation and tooling. New editions ship through the usual
 release process.
+-->
+
+2,3年に一度、Rustの新しい「エディション」を作成します。
+各エディションはそれまでRustに加えられた変更をまとめ上げたもので、最新のドキュメントとツールもそれに含まれます。
+新しいエディションは通常のリリースプロセスを経てリリースされます。
 
+<!--
 This serves different purposes for different people:
 
 - For active Rust users, it brings together incremental changes into an
@@ -21,9 +38,23 @@ This serves different purposes for different people:
 
 - For those developing Rust itself, it provides a rallying point for the project as a
   whole.
+  -->
+
+エディションは様々な人の異なる要求を満たします。
+
+- Rustのアクティブなユーザーにとっては、6週間ごとににリリースされた機能変更をわかりやすくまとめたパッケージとなります。
+
+- Rustを使っていない人にとっては、大きな変更が施されたことを知らせる役割を果たし、それによってRustを使ってみようと思うようになるかも知れません。
 
+- Rustの内部開発者にとっては、プロジェクト全体の長期的なゴールになります。
+
+
+<!--
 ## Compatibility
+-->
+## 互換性
 
+<!--
 When a new edition becomes available in the compiler, crates must explicitly opt
 in to it to take full advantage. This opt in enables editions to contain
 incompatible changes, like adding a new keyword that might conflict with
@@ -34,10 +65,26 @@ Edition changes only affect the way the compiler initially parses the code.
 Therefore, if you're using Rust 2015, and
 one of your dependencies uses Rust 2018, it all works just fine. The opposite
 situation works as well.
+-->
+
+新しいエディションがコンパイラで利用可能になった際に、その利点を最大限に活かすためには、クレートは明示的にオプトインする必要があります。
+このオプトインはエディションに非互換の変更を加えるために必要で、例えば、既存のコードで使われている識別子と競合する新たなキーワードを導入したり、警告だったものをエラーにする、などの変更を加えることができるようになります。
+Rustのコンパイラはこれまでの全てのエディションをサポートしていて、複数のクレートが異なるエディションを使用していても一つにリンクできます。
+エディションの変更はコンパイラが最初にコードを構文解析する際の動作のみに影響します。
+従って、例ばあなたがRust 2015を使っていて、依存するクレートが Rust 2018を使っていても全く問題なく動作します。
+その逆の場合も同様です。
 
+
+<!--
 Just to be clear: most features will be available on all editions.
 People using any edition of Rust will continue to see improvements as new
 stable releases are made.  In some cases however, mainly when new keywords are
 added, but sometimes for other reasons, there may be new features that are only
 available in later editions.  You only need to upgrade if you want to take
-advantage of such features.
+advantage of such features.
+-->
+
+念の為はっきりさせておきますが、ほとんどの機能は全てのエディションで利用可能です。
+どのエディションを利用していても、新たな安定板リリースが出た際には改善を見ることができます。
+時折、例えば新たなキーワードが導入されたりその他の理由で、あるエディション以降でしか利用できない機能追加があります。
+そのような機能を利用したい時にエディションのアップデートを検討するのが良いでしょう。