Merge pull request #6984 from softark/docs-guide-ja-intro-refined

docs/guide-ja/README.md

 Yii 2.0 決定版ガイド
 ====================
 
-このチュートリアルは [Yii ドキュメント規約](http://www.yiiframework.com/doc/terms/) の下にリリースされています。
+このチュートリアルは [Yii ドキュメント許諾条件](http://www.yiiframework.com/doc/terms/) の下にリリースされています。
 
 All Rights Reserved.
 
@@ -20,11 +20,11 @@ All Rights Reserved.
 
 * [Yii をインストールする](start-installation.md)
 * [アプリケーションを走らせる](start-workflow.md)
-* [「こんにちは」と言う](start-hello.md)
+* [こんにちは、と言う](start-hello.md)
 * [フォームを扱う](start-forms.md)
 * [データベースを扱う](start-databases.md)
 * [Gii でコードを生成する](start-gii.md)
-* [この先を見通す](start-looking-ahead.md)
+* [先を見通す](start-looking-ahead.md)
 
 
 アプリケーションの構造
@@ -74,14 +74,14 @@ All Rights Reserved.
 データベースの取り扱い
 ----------------------
 
-* [データアクセスオブジェクト](db-dao.md): データベースへの接続、基本的なクエリ、トランザクション、および、スキーマ操作
+* [データベースアクセスオブジェクト](db-dao.md): データベースへの接続、基本的なクエリ、トランザクション、および、スキーマ操作
 * [クエリビルダ](db-query-builder.md): シンプルな抽象レイヤを使ってデータベースに対してクエリを行う
 * [アクティブレコード](db-active-record.md): アクティブレコード ORM、レコードの読み出しと操作、リレーションの定義
 * [マイグレーション](db-migrations.md): チーム開発環境においてデータベースにバージョンコントロールを適用
-* **TBD** [Sphinx](db-sphinx.md)
-* **TBD** [Redis](db-redis.md)
-* **TBD** [MongoDB](db-mongodb.md)
-* **TBD** [ElasticSearch](db-elasticsearch.md)
+* **未定** [Sphinx](db-sphinx.md)
+* **未定** [Redis](db-redis.md)
+* **未定** [MongoDB](db-mongodb.md)
+* **未定** [ElasticSearch](db-elasticsearch.md)
 
 
 ユーザからのデータ取得
@@ -90,7 +90,7 @@ All Rights Reserved.
 * [フォームを作成する](input-forms.md)
 * [入力を検証する](input-validation.md)
 * [ファイルをアップロードする](input-file-upload.md)
-* **TBD** [複数モデルのためのデータ取得](input-multiple-models.md)
+* **未定** [複数モデルのデータ取得](input-multiple-models.md)
 
 
 データの表示
@@ -144,7 +144,7 @@ RESTful ウェブサービス
 
 * [デバッグツールバーとデバッガ](tool-debugger.md)
 * [Gii を使ってコードを生成する](tool-gii.md)
-* **TBD** [API ドキュメントを生成する](tool-api-doc.md)
+* **未定** [API ドキュメントを生成する](tool-api-doc.md)
 
 
 テスト
@@ -152,7 +152,7 @@ RESTful ウェブサービス
 
 * [概要](test-overview.md)
 * [テスト環境の構築](test-environment-setup.md)
-* [ユニットテスト](test-unit.md)
+* [単体テスト](test-unit.md)
 * [機能テスト](test-functional.md)
 * [承認テスト](test-acceptance.md)
 * [フィクスチャ](test-fixtures.md)
@@ -176,14 +176,14 @@ RESTful ウェブサービス
 ウィジェット
 ------------
 
-* GridView: **TBD** link to demo page
-* ListView: **TBD** link to demo page
-* DetailView: **TBD** link to demo page
-* ActiveForm: **TBD** link to demo page
-* Pjax: **TBD** link to demo page
-* Menu: **TBD** link to demo page
-* LinkPager: **TBD** link to demo page
-* LinkSorter: **TBD** link to demo page
+* GridView: **未定** デモページへリンク
+* ListView: **未定** デモページへリンク
+* DetailView: **未定** デモページへリンク
+* ActiveForm: **未定** デモページへリンク
+* Pjax: **未定** デモページへリンク
+* Menu: **未定** デモページへリンク
+* LinkPager: **未定** デモページへリンク
+* LinkSorter: **未定** デモページへリンク
 * [Bootstrap ウィジェット](widget-bootstrap.md)
 * [jQuery UI ウィジェット](widget-jui.md)
 

docs/guide-ja/intro-yii.md

@@ -3,10 +3,10 @@ Yii とは何か
 
 Yii は現代的なウェブアプリケーションを迅速に開発するための、高性能な、コンポーネントベースの PHP フレームワークです。
 Yii という名前 (`イー` すなわち `[ji:]` と発音します) は、中国語では「易」であり、「シンプルかつ進化的」であることを意味します。
-また **Yes It Is** のアクロニム(頭字語)であると考えることも出来ます。
+また **Yes It Is** のアクロニム (頭字語) であると考えることも出来ます。
 
 
-Yii は何に向いているか
+Yii は何に適しているか
 ----------------------
 
 Yii は汎用的なウェブプログラミングフレームワークです。
@@ -14,23 +14,23 @@ Yii は汎用的なウェブプログラミングフレームワークです。
 コンポーネントベースのアーキテクチャと洗練されたキャッシュサポートを持っているため、Yii は大規模なアプリケーション、たとえば、ポータル、フォーラム、コンテンツマネージメントシステム (CMS)、電子商取引プロジェクト、RESTful ウェブサービス、等々を開発するのに特に適しています。
 
 
-Yii を他のフレームワークと比べるとどうか?
------------------------------------------
+Yii を他のフレームワークと比べると
+----------------------------------
 
-あなたが既に他のフレームワークに親しんでいる場合は、Yii を比較するとどうなるのかを知りたいと思うでしょう。
+あなたが既に他のフレームワークに親しんでいる場合は、Yii を比較するとどうなのかを知りたいでしょう。
 
 - ほとんどの PHP フレームワーク同様、Yii は MVC (Model-View-Controller) デザインパターンを実装し、このパターンに基づいたコードの組織化を推進しています。
 - Yii は、コードはシンプルかつエレガントに書かれるべきである、という哲学を採用しています。
-  Yii は、何らかのデザインパターンを厳密に守ることを主たる目的として大袈裟な設計をすることは、決してしようとしません。
-- Yii は、検証済みで直ちに使える多数の機能を提供するフル装備のフレームワークです。
-  リレーショナルデータベースと NoSQL データベースの両方のためのクエリビルダとアクティブレコード、RESTful API 開発サポート、多層構成のキャッシュサポート、その他諸々。
+  何らかのデザインパターンの厳密な遵守を主な目的とする凝りすぎた設計を、Yii がしようと試みることは決してありません。
+- Yii はフル装備のフレームワークです。
+  クエリビルダ、リレーショナルデータベースと NoSQL データベースの双方のためのアクティブレコード、RESTful API 開発サポート、多層構成のキャッシュサポート、その他、検証済みで直ちに使える多数の機能を提供します。
 - Yii は極めて拡張性の高いフレームワークです。あなたはコアのコードのほとんど全ての要素をカスタマイズしたり置き換えたりすることが出来ます。
   また、Yii の堅固なエクステンションアーキテクチャを利用して、再配布可能なエクステンションを使用したり開発したりすることも出来ます。
 - 高性能であることは常に Yii の主たる目標です。
 
 Yii はワンマンショーではありません。Yii は [強力なコア開発チーム][] および Yii 開発に間断なく貢献してくれるプロフェッショナルの大きなコミュニティーに支えられたプロジェクトです。
-Yii 開発チームは最新のウェブ開発の潮流や、他のフレームワークやプロジェクトに見られるベストプラクティスと機能から目を離しません。
-他のところで見出された関連性の高いベストプラクティスと機能は、定期的にコアフレームワークに組み込まれ、シンプルかつエレガントなインターフェイスを通じて公開されます。
+Yii 開発チームは、最新のウェブ開発の潮流と、他のフレームワークやプロジェクトに見出される最善のプラクティスと機能を、注意深く見守り続けています。
+他のところで見出された最善のプラクティスと機能で最も適切なものは、定期的にコアフレームワークに組み込まれ、シンプルかつエレガントなインターフェイスを通じて公開されます。
 
 [強力なコア開発チーム]: http://www.yiiframework.com/about/
 
@@ -48,10 +48,10 @@ Yii は現在、利用可能な二つのメジャーバージョン、すなわ
 ------------------
 
 Yii 2.0 は PHP 5.4.0 以上を必要とします。
-個別の機能に対する詳細な必要条件は、全ての Yii リリースに含まれている必要条件チェッカを走らせることによって知ることが出来ます。
+個々の機能に対する詳細な必要条件は、全ての Yii リリースに含まれている必要条件チェッカを走らせることによって知ることが出来ます。
 
 Yii を使うためには、オブジェクト指向プログラミング (OOP) の基本的な知識が必要です。
 なぜなら、Yii は純粋な OOP ベースのフレームワークだからです。
 また、Yii 2.0 は [名前空間](http://php.net/manual/ja/language.namespaces.php) や [トレイト](http://php.net/manual/ja/language.oop5.traits.php) のような PHP の最新の機能を利用しています。
-これらの概念を理解することは、Yii 2.0 を採用することをより一層容易にするでしょう。
+これらの概念を理解することは、Yii 2.0 を採用することを一層容易にするでしょう。