Merge pull request #6333 from softark/docs-guide-ja-update

docs/guide-ja/README.md

@@ -188,12 +188,12 @@ RESTful ウェブサービス
 * [Jquery UI ウィジェット](widget-jui.md)
 
 
-ヘルパー
---------
+ヘルパ
+------
 
 * [概要](helper-overview.md)
-* **TBD** [ArrayHelper](helper-array.md)
+* [ArrayHelper](helper-array.md)
 * **TBD** [Html](helper-html.md)
-* **TBD** [Url](helper-url.md)
+* [Url](helper-url.md)
 * **TBD** [Security](helper-security.md)
 

docs/guide-ja/start-installation.md

@@ -4,7 +4,18 @@ Yii 繧偵う繝ｳ繧ｹ繝医繝ｫ縺吶ｋ
 Yii は二つの方法でインストールできます。[Composer](http://getcomposer.org/) を使う方法とアーカイブファイルをダウンロードする方法です。
 前者がお薦めの方法です。と言うのは、一つのコマンドを走らせるだけで、新しい[エクステンション](structure-extensions.md) をインストールしたり、Yii をアップデートしたり出来るからです。
 
-> Note|注意: Yii 1 とは異なり、Yii 2 の標準的なインストールを実行すると、フレームワークとアプリケーションスケルトンの両方がダウンロードされてインストールされます。
+Yii の標準的なインストールを実行すると、フレームワークとアプリケーションテンプレートの両方がダウンロードされてインストールされます。
+アプリケーションテンプレートは、いくつかの基本的な機能、例えば、ログインやコンタクトフォームなどを実装した、動作する Yii アプリケーションです。
+そのコードは推奨される方式に従って組織されています。
+そのため、アプリケーションテンプレートは、あなたのプロジェクトのための好ましい開始点としての役割を果たしうるものです。
+
+この節と後続のいくつかの節においては、いわゆる *ベーシックアプリケーションテンプレート* とともに Yii をインストールする方法、および、このテンプレート上に新しい機能を実装する方法を説明します。
+Yii は [アドバンストアプリケーションテンプレート](tutorial-advanced-app.md) と呼ばれるもう一つのテンプレートも提供しています。
+こちらは、チーム開発環境において多層構造のアプリケーションを開発するときに使用する方が望ましいものです。
+
+> Info|情報: ベーシックアプリケーションテンプレートは、ウェブアプリケーションの 90 パーセントを開発するのに適したものです。
+  アドバンストアプリケーションテンプレートとの主な違いは、コードがどのように組織されているかという点にあります。
+  あなたが Yii は初めてだという場合は、シンプルでありながら十分な機能を持っていることを理由にして、ベーシックアプリケーションテンプレートに留まることを強く推奨します。
 
 
 Composer によるインストール<a name="installing-via-composer"></a>
@@ -34,11 +45,9 @@ Composer 縺後う繝ｳ繧ｹ繝医繝ｫ縺輔ｌ縺溘ｉ縲√え繧ｧ繝悶°繧峨い繧ｯ繧ｻ繧ｹ縺ｧ縺阪
 第二のコマンドは `basic` という名前のディレクトリに Yii をインストールします。
 必要なら別のディレクトリ名を選ぶことも出来ます。
 
-> Note|注意: インストール実行中に Composer が あなたの Github アカウントの認証情報を尋ねてくることがあるかも知れません。
-> これは、Comoser が Github API の転送レート制限にひっかかったためです。
-> Composer は全てのパッケージのための大量の情報を Github から読み出さなければならないので、こうなるのは普通のことです。
-> Github にログインすると API の転送レート制限が緩和され、Composer が仕事を続けることが出来るようになります。
-> 詳細については、[Composer documentation](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens) を参照してください。
+> Note|注意: インストール実行中に Composer が あなたの Github のログイン認証情報を求めることがあるかも知れません。
+> これは、Comoser が依存パッケージの情報を Github から読み出すために十分な転送レートを必要とするためで、普通にあることです。
+> 詳細については、[Composer ドキュメント](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens) を参照してください。
 
 > Tip|ヒント: Yii の最新の開発バージョンをインストールしたい場合は、[stability option](https://getcomposer.org/doc/04-schema.md#minimum-stability) を追加した次のコマンドを代りに使うことが出来ます。
 >
@@ -67,7 +76,8 @@ Composer 縺後う繝ｳ繧ｹ繝医繝ｫ縺輔ｌ縺溘ｉ縲√え繧ｧ繝悶°繧峨い繧ｯ繧ｻ繧ｹ縺ｧ縺阪
 --------------------------
 
 上記のインストール方法の説明は Yii のインストールの仕方を示すものですが、それは同時にそのままで動作する基本的なウェブアプリケーションを作成するものでもあります。
-これは小さなプロジェクトを開始するのに良い方法です。あるいは Yii の学習を始めたばかりの場合にもこれで良いでしょう。
+これは、規模の大小に関わらず、ほとんどのプロジェクトを開始するのに良い方法です。
+特に、Yii の学習を始めたばかりの場合には、この方法が適しています。
 
 しかし、他のインストールオプションも利用可能です。
 

docs/internals-ja/design-decisions.md

+設計上の決定
+============
+
+この文書は、私たちが詳細な議論の末に達した設計上の決定を記載するものです。
+非常に強固な理由があるのでない限りは、これらの決定は一貫性のために守られなければなりません。
+これらの決定に対するいかなる変更もコア開発者間の同意を得なければなりません。
+
+1. **[いかなる時にパスエイリアスをサポートするか](https://github.com/yiisoft/yii2/pull/3079#issuecomment-40312268)**
+   構成情報にパスエイリアスを使用することは非常に利便性が高いため、構成可能なプロパティに対してはパスエイリアスをサポートすべきである。
+   その他の場合には、パスエイリアスに対するサポートを制限すべきである。
+2. **いかなる時にメッセージを翻訳するか**
+   技術者でないエンドユーザに対して表示され、また、そういうユーザに対して意味を持つメッセージは翻訳されるべきである。
+   HTTP ステータスメッセージ、コードに関する例外などは翻訳されるべきではない。
+   コンソールメッセージは、エンコーディングとコードページの処理に困難が伴うため、常に英語で表示されるものとする。