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

docs/guide-ja/tutorial-mailing.md

@@ -4,8 +4,8 @@
 > Note|注意: この節はまだ執筆中です。
 
 Yii は電子メールの作成と送信をサポートしています。
-ただし、フレームワークのコアは内容作成の機能と基本的なインタフェイスだけを提供します。
-実際のメール送信メカニズムはエクステンションによって提供されるべきです。
+ただし、フレームワークのコアはコンテント作成の機能と基本的なインタフェイスだけを提供します。
+実際のメール送信メカニズムはエクステンションによって提供されなければなりません。
 と言うのは、メール送信はプロジェクトが異なるごとに異なる実装が必要とされるでしょうし、通常、外部のサービスやライブラリに依存するものだからです。
 
 ごく一般的な場合であれば、[yii2-swiftmailer](https://github.com/yiisoft/yii2/tree/master/extensions/swiftmailer) 公式エクステンションを使用することが出来ます。
@@ -76,7 +76,7 @@ foreach ($users as $user) {
 Yii::$app->mailer->sendMultiple($messages);
 ```
 
-几帳面なメールエクステンションの中には、単一のネットワークメッセージを使うなどして、この手法から利益を得るものもあるかもしれません。
+芸の細かいメールエクステンションであれば、単一のネットワークメッセージを使うなどして、この手法の恩恵を享受することが出来るでしょう。
 
 
 メールのコンテントを作成する
@@ -120,7 +120,7 @@ Yii::$app->mailer->compose('greetings', [
 ]);
 ```
 
-HTML とプレーンテキストのメッセージコンテントに違うビューを指定することが出来ます。
+HTML と平文テキストのメッセージコンテントに違うビューを指定することが出来ます。
 
 ```php
 Yii::$app->mailer->compose([
@@ -129,7 +129,8 @@ Yii::$app->mailer->compose([
 ]);
 ```
 
-ビュー名をスカラーの文字列として渡した場合は、そのレンダリング結果は HTML ボディとして使われ、プレーンテキストのボディは HTML のボディから全ての HTML 要素を削除することによって作成されます。
+ビュー名をスカラーの文字列として渡した場合は、そのレンダリング結果は HTML ボディとして使われます。
+そして、平文テキストのボディは HTML のボディから全ての HTML 要素を削除することによって作成されます。
 
 ビューのレンダリング結果はレイアウトで包むことが出来ます。
 レイアウトは、[[yii\mail\BaseMailer::htmlLayout]] と [[yii\mail\BaseMailer::textLayout]] を使ってセットアップすることが可能です。
@@ -187,7 +188,7 @@ $message->attachContent('添付される内容', ['fileName' => 'attach.txt', 'c
 --------------
 
 `embed()` メソッドを使って、メッセージのコンテントに画像を埋め込むことが出来ます。
-このメソッドは添付されるファイルのコンテント ID を返しますので、それを 'img' タグで使わなければなりません。
+このメソッドは添付ファイルの ID を返しますので、それを 'img' タグで使わなければなりません。
 このメソッドはビューファイルによってメッセージのコンテントを作成するときに簡単に使うことが出来ます。
 
 ```php

docs/guide-ja/tutorial-performance-tuning.md

@@ -39,7 +39,7 @@ defined('YII_DEBUG') or define('YII_DEBUG', false);
 
 PHP opcode キャッシュを有効にすると、すべての PHP アプリケーションで、顕著にパフォーマンスが向上し、メモリ使用量が削減されます。
 Yii も例外ではありません。
-[PHP 5.5 OPcache](http://php.net/manual/ja/book.opcache.php) と [APC PHP 拡張](http://php.net/manual/ja/book.apc.php) の両方でテストされています。
+Yii は [PHP 5.5 OPcache](http://php.net/manual/ja/book.opcache.php) と [APC PHP 拡張](http://php.net/manual/ja/book.apc.php) の両方でテストされています。
 どちらのキャッシュも、PHP 中間コードを最適化して、入ってくるリクエストごとに PHP スクリプトを解析するために時間を消費することを回避します。
 
 ### ActiveRecord のデータベーススキーマキャッシュを有効にする
@@ -226,7 +226,7 @@ foreach ($posts as $post) {
 ### 何をしても効果がない場合
 
 何をしても効果がない場合は、何がパフォーマンスの問題を解決するかについての思い込みを排することです。
-代りに、何でも変更する前には、常にコードをプロファイルにかけてください。
+代りに、いつでも、何かを変更する前にはコードをプロファイルしてください。
 次のツールが役に立つでしょう。
 
 - [Yii のデバッグツールバーとデバッガ](tool-debugger.md)

docs/guide-ja/tutorial-shared-hosting.md

@@ -44,7 +44,7 @@ www
 別の名前かもしれません。よくある名前は、`www`、`htdocs`、`public_html` です。
 ベーシックアプリケーションテンプレートではウェブルートの名前は `web` になっていますので、アップロードする前に、これをホストのウェブルートの名前に変更する必要があります。
 
-### FTP ルートディレクトリは書き込み可能とする
+### FTP ルートディレクトリは書き込み可能
 
 ルートレベルのディレクトリ、すなわち、`config`、`logs`、`www` があるディレクトリに対して書き込みが出来るのであれば、`assets`、`commands` などをそのままアップロードします。
 
@@ -65,7 +65,7 @@ Yii を走らせるためには、ホストは Yii の必要条件を満たさ
 
 ### エントリスクリプトを単一のウェブルートに移動する
 
-まずは、単一のウェブルートディレクトリが必要です。
+まずは、ウェブルートディレクトリが必要です。
 上記の [ウェブルートの名前を変える](#renaming-webroot) で説明したように、あなたのホストのウェブルートに合うように名前を付けてください。
 次に、以下のような構造を作成します。
 

docs/guide-ja/tutorial-template-engines.md

@@ -78,7 +78,7 @@ Twig の基礎を学ぶための最善のリソースは、[twig.sensiolabs.org]
 {{ myObject.my_function({'a' : 'b'}) }}
 ```
 
-結果を必要としない場合は、`void` ラッパーを使うべきです。
+結果を必要としない場合は、`void` ラッパーを使わなければなりません。
 
 ```
 {{ void(my_function({'a' : 'b'})) }}

docs/guide-ja/tutorial-yii-integration.md

@@ -1,7 +1,7 @@
 サードパーティのコードを扱う
 ============================
 
-時々、Yii アプリケーションの中でサードパーティのコードを使用する必要がある場合があります。
+時々、Yii アプリケーションの中でサードパーティのコードを使用する必要があることがあります。
 あるいは、サードパーティのシステムの中で Yii をライブラリとして使用したいこともあるでしょう。
 この節では、こういう目的をどうやって達成するかを説明します。
 
@@ -9,7 +9,7 @@
 Yii の中でサードパーティのライブラリを使う <span id="using-libs-in-yii"></span>
 ------------------------------------------
 
-Yii アプリケーションの中でサードパーティのライブラリを使うために主として必要なことは、そのライブラリの中のクラスが適切にインクルードされること、または、オートロード可能な状態にあることを保証することです。
+Yii アプリケーションの中でサードパーティのライブラリを使うために主として必要なことは、そのライブラリのクラスが適切にインクルードされること、または、オートロード可能であることを保証することです。
 
 ### Composer パッケージを使う <span id="using-composer-packages"></span>