docs/guide-ja/tutorial - reviewing [ci skip]

docs/guide-ja/tutorial-advanced-app.md

@@ -3,8 +3,8 @@
 
 > Note|注意: この節はまだ執筆中です。
 
-このテンプレートは、チームによって開発される大規模なプロジェクトのためのもので、バックエンドはフロントエンドから分離され、アプリケーションは複数のサーバに配備されます。
-また、このアプリケーションテンプレートは機能に関して少し大きく踏み込んで、不可欠なデータベースやユーザ登録、パスワード回復などをそのまま使える形で提供しています。
+このテンプレートは、バックエンドがフロントエンドから分離されたり、アプリケーションが複数のサーバに配備されたりするような、チーム開発による大規模なプロジェクトのためのものです。
+また、このアプリケーションテンプレートは機能に関して少し踏み込んで、不可欠なデータベースやユーザ登録、パスワード回復などをそのまま使える形で提供しています。
 
 次の表はアドバンストとベーシックのアプリケーションテンプレートの違いを比較するものです。
 
@@ -56,7 +56,7 @@ Composer がインストールされていれば、次のコマンドを使っ
     php /path/to/yii-application/init
     ```
 
-    非対話モードを使っても構いません。本番環境であれば、
+    あるいは、本番サーバで、非対話モードで `init` を実行します。
 
     ```
     php /path/to/yii-application/init --env=Production --overwrite=All
@@ -70,7 +70,7 @@ Composer がインストールされていれば、次のコマンドを使っ
 - バックエンドのパスは `/path/to/yii-application/backend/web/`、URL は `http://backend/` を使用
 
 アプリケーションにログインするためには、最初にユーザ登録をする必要があります。
-メールアドレス、ユーザ名、パスワードは何でも構いません。
+あなたの任意のメールアドレス、ユーザ名、パスワードを指定してください。
 そうすれば、同じメールアドレスとパスワードを使って何時でもアプリケーションにログインすることが出来ます。
 
 ディレクトリ構造
@@ -84,14 +84,14 @@ Composer がインストールされていれば、次のコマンドを使っ
 - `environments` - 環境設定
 - `frontend` - フロントエンドのアプリケーション
 
-ルートディレクトリは次の一連のファイルを含みます。
+ルートディレクトリは次の一群のファイルを含みます。
 
 - `.gitignore` - git バージョン管理システムによって無視されるディレクトリの一覧を含みます。
   ソースコードのレポジトリに決して入れたくないものがあれば、それをこれに追加してください。
 - `composer.json` - Composer の構成。下の「Composer を構成する」で説明します。
 - `init` - 初期化スクリプト。下の「構成情報と環境」で説明します。
 - `init.bat` - 同上 (Windows 用)。
-- `LICENSE.md` - ライセンス情報。プロジェクトのライセンスを置きます。特にオープンソースにする場合は。
+- `LICENSE.md` - ライセンス情報。プロジェクトのライセンスを置きます。特にオープンソースにする場合。
 - `README.md` - テンプレートのインストールに関する基本的な情報。
   あなたのプロジェクトとそのインストールに関する情報に置き換えることを検討してください。
 - `requirements.php` - Yii 必要条件チェッカ。
@@ -125,7 +125,7 @@ Composer がインストールされていれば、次のコマンドを使っ
 フロントエンドは典型的にはエンドユーザに提示されるもので、プロジェクトの本体です。
 バックエンドは管理パネルや、分析などの機能です。
 コンソールは典型的にはクロンジョブや低レベルのサーバ管理に使用されます。
-コンソールは、また、アプリケーションの配置の際にも使われ、マイグレーションやアセットを処理します。
+コンソールは、また、アプリケーションの配備の際にも使われ、マイグレーションやアセットを処理します。
 
 さらに、二つ以上のアプリケーションから使われるファイルを含む `common` ディレクトリがあります。
 例えば、`User` モデルがそうです。
@@ -144,12 +144,12 @@ Composer がインストールされていれば、次のコマンドを使っ
 - チームの各メンバーは、自分自身の構成オプションを持っています。
   そのような構成をコミットすると、他のメンバーに影響を与えます。
 - 本番のデータベースのパスワードと API キーは、レポジトリに入れるべきではありません。
-- 複数サーバの環境があります。すなわち、開発、テスト、本番などです。各サーバはそれ自身の構成情報を持たなければなりません。
+- 複数のサーバ環境があります。すなわち、開発、テスト、本番などです。各サーバはそれ自身の構成情報を持たなければなりません。
 - 全ての構成オプションを各ケースに対して定義することは反復の多い作業であり、保守するのに時間を取りすぎます。
 
-これらの問題を解決するために、Yii は環境という単純な概念を導入しています。
-それぞれの環境は `environments` ディレクトリ配下の一連のファイルとして表現されます。
-`init` コマンドが環境を切り替えるのに使用されます。
+これらの問題を解決するために、Yii は単純な環境の概念を導入しています。
+それぞれの環境は `environments` ディレクトリ配下の一群のファイルとして表現されます。
+`init` コマンドがこれらの環境を切り替えるのに使用されます。
 `init` コマンドが実際にやっていることは、環境ディレクトリから、全てのアプリケーションがあるルートディレクトリへと、すべてをごっそりとコピーすることです。
 
 デフォルトでは二つの環境があります。すなわち、`dev` と `prod` です。
@@ -226,7 +226,7 @@ Composer を構成する
 ```
 
 最初に、基本的な情報を更新しましょう。
-`name`、`description`、`keywords`、`homepage` および `support` をあなたのプロジェクトに会うように変更します。
+`name`、`description`、`keywords`、`homepage` および `support` をあなたのプロジェクトに合うように変更します。
 
 次に興味深い部分です。
 あなたは、あなたのアプリケーションが必要とするパッケージを `require` セクションに追加することが出来ます。

docs/guide-ja/tutorial-console.md

@@ -5,8 +5,8 @@
 
 Yii はフル機能のコンソールアプリケーションをサポートしています。
 コンソールアプリケーションの構造は Yii のウェブアプリケーションのそれと非常に良く似ています。
-コンソールアプリケーションは一つまたは複数の [[yii\console\Controller]] から構成されます。
-コントローラはコンソール環境では通常「コマンド」と呼ばれます。
+コンソールアプリケーションは一つまたは複数の [[yii\console\Controller]] クラスから構成されます。
+コントローラはコンソール環境ではしばしば「コマンド」と呼ばれます。
 また、各コントローラは、ウェブのコントローラと全く同じように、一つまたは複数のアクションを持つことが出来ます。
 
 
@@ -93,7 +93,7 @@ exit($exitCode);
 
 コンソールコマンドは、[[yii\console\Controller]] を拡張するコントローラクラスとして定義することが出来ます。
 コントローラクラスの中で、コントローラのサブコマンドに対応する一つまたは複数のアクションを定義します。
-各アクションの中で、特定のサブコマンドのために、適切なタスクを実装するコードを書きます。
+各アクションの中で、その特定のサブコマンドのための適切なタスクを実装するコードを書きます。
 
 コマンドを実行するときは、コントローラのアクションに対するルートを指定する必要があります。
 例えば、ルート `migrate/create` は、[[yii\console\controllers\MigrateController::actionCreate()|MigrateController::actionCreate()]] アクションメソッドに対応するサブコマンドを呼び出します。

docs/guide-ja/tutorial-start-from-scratch.md

@@ -6,7 +6,7 @@
 [ベーシック](https://github.com/yiisoft/yii2/tree/master/apps/basic) と [アドバンスト](https://github.com/yiisoft/yii2/tree/master/apps/advanced) のアプリケーションテンプレートは、あなたの要求をほとんどカバーする優れたものですが、あなたのプロジェクトを開始するためのあなた自身のテンプレートを作成したいこともあるでしょう。
 
 Yii におけるアプリケーションテンプレートは、`composer.json` ファイルを含み、Composer パッケージとして登録されたレポジトリであるに過ぎません。
-どのようなレポジトリでも、Composer パッケージとして特定し、`create-project` Composer コマンドによってインストール可能なものとすることが可能です。
+どのようなレポジトリでも、Composer パッケージとして特定し、`create-project` Composer コマンドによってインストール可能なものにすることが出来ます。
 
 テンプレート全体を最初から構築するのは少々大変ですので、内蔵のテンプレートの一つを基礎として使うのが良いでしょう。
 ここでは、ベーシックテンプレートを使いましょう。
@@ -21,7 +21,7 @@ git clone git@github.com:yiisoft/yii2-app-basic.git
 ```
 
 そして、レポジトリがあなたのコンピュータにダウンロードされるのを待ちます。
-テンプレートに加えた変更はプッシュバックされませんので、ダウンロードしたものから `.git` ディレクトリとその中身を全て削除して構いません。
+テンプレートに加えられた変更がレポジトリにプッシュバックされることはありませんので、ダウンロードしたものから `.git` ディレクトリとその中身を全て削除して構いません。
 
 ファイルを修正する
 ------------------
@@ -30,9 +30,9 @@ git clone git@github.com:yiisoft/yii2-app-basic.git
 `name`、`description`、`keywords`、`homepage`、`license` および `support` の値を、あなたの新しいテンプレートを説明するものに変更します。
 また、`require`、`require-dev`、`suggest` や、その他のオプションも、あなたのテンプレートの要求に合うように調整します。
 
-> Note|注意: `composer.json` ファイルで、`extra` の下の `writable` パラメータを使って、アプリケーションがテンプレートを使って作成された後に設定すべきファイル単位のアクセス権限を指定してください。
+> Note|注意: `composer.json` ファイルで、`extra` の下の `writable` パラメータを使って、アプリケーションがテンプレートを使って作成された後に設定されるべきファイル単位のアクセス権限を指定してください。
 
-次に、あなたがデフォルトとしたいと思うように、アプリケーションの構造と内容を実際に修正します。
+次に、あなたが好むデフォルトの状態に合うように、アプリケーションの構造と内容を実際に修正します。
 最後に、あなたのテンプレートに適用できるように、README ファイルを更新します。
 
 パッケージを作る