diff --git a/docs/guide-ja/README.md b/docs/guide-ja/README.md
index b9af4c4f63..ad31716949 100644
--- a/docs/guide-ja/README.md
+++ b/docs/guide-ja/README.md
@@ -178,14 +178,14 @@ RESTful ウェブサービス
ウィジェット
------------
-* GridView: **未定** デモページへリンク
-* ListView: **未定** デモページへリンク
-* DetailView: **未定** デモページへリンク
-* ActiveForm: **未定** デモページへリンク
-* Pjax: **未定** デモページへリンク
-* Menu: **未定** デモページへリンク
-* LinkPager: **未定** デモページへリンク
-* LinkSorter: **未定** デモページへリンク
+* [GridView](http://www.yiiframework.com/doc-2.0/yii-grid-gridview.html)
+* [ListView](http://www.yiiframework.com/doc-2.0/yii-widgets-listview.html)
+* [DetailView](http://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html)
+* [ActiveForm](http://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform)
+* [Pjax](http://www.yiiframework.com/doc-2.0/yii-widgets-pjax.html)
+* [Menu](http://www.yiiframework.com/doc-2.0/yii-widgets-menu.html)
+* [LinkPager](http://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html)
+* [LinkSorter](http://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html)
* [Bootstrap ウィジェット](https://github.com/yiisoft/yii2-bootstrap/blob/master/docs/guide-ja/README.md)
* [jQuery UI ウィジェット](https://github.com/yiisoft/yii2-jui/blob/master/docs/guide-ja/README.md)
diff --git a/docs/guide-ja/intro-yii.md b/docs/guide-ja/intro-yii.md
index 8322afc899..b56c87f428 100644
--- a/docs/guide-ja/intro-yii.md
+++ b/docs/guide-ja/intro-yii.md
@@ -46,7 +46,7 @@ Yii は現在、利用可能な二つのメジャーバージョン、すなわ
必要条件と前提条件
------------------
-Yii 2.0 は PHP 5.4.0 以上を必要とします。
+Yii 2.0 は PHP 5.4.0 以上を必要とし、PHP 7 の最新バージョンで最高の力を発揮します。
個々の機能に対する詳細な必要条件は、全ての Yii リリースに含まれている必要条件チェッカを走らせることによって知ることが出来ます。
Yii を使うためには、オブジェクト指向プログラミング (OOP) の基本的な知識が必要です。
diff --git a/docs/guide-ja/output-client-scripts.md b/docs/guide-ja/output-client-scripts.md
index f0c71dcb3a..cc8b4cd741 100644
--- a/docs/guide-ja/output-client-scripts.md
+++ b/docs/guide-ja/output-client-scripts.md
@@ -1,70 +1,85 @@
クライアントスクリプトを扱う
============================
-> Note: この節はまだ執筆中です。
+今日のウェブアプリケーションでは、静的な HTML ページがレンダリングされてブラウザに送信されるだけでなく、
+JavaScript によって、既存の要素を操作したり、新しいコンテントを AJAX でロードしたりして、ブラウザに表示されるページを修正します。
+この節では、JavaScript と CSS をウェブサイトに追加したり、それらを動的に調整するために Yii によって提供されているメソッドを説明します。
-### スクリプトを登録する
+## スクリプトを登録する
-[[yii\web\View]] オブジェクトに対してスクリプトを登録することが出来ます。
+[[yii\web\View]] オブジェクトを扱う際には、フロントエンドスクリプトを動的に登録することが出来ます。
このための専用のメソッドが二つあります。
-すなわち、インラインスクリプトのための [[yii\web\View::registerJs()|registerJs()]] と、外部スクリプトのための [[yii\web\View::registerJsFile()|registerJsFile()]] です。
-インラインスクリプトは、設定のためや、動的に生成されるコードのために有用なものです。
-次のようにして、これらを追加するメソッドを使うことが出来ます。
+
+- インラインスクリプトのための [[yii\web\View::registerJs()|registerJs()]]
+- 外部スクリプトのための [[yii\web\View::registerJsFile()|registerJsFile()]]
+### インラインスクリプトを登録する
+
+インラインスクリプトは、設定や、動的に生成されるコードのために有用なものです。
+また、[ウィジェット](structure-widgets.md) に含まれる再利用可能なフロントエンドコードによって生成されるコード断片もインラインスクリプトです。
+インラインスクリプトを追加するためのメソッド [[yii\web\View::registerJs()|registerJs()]] は、次のようにして使うことが出来ます。
```php
-$this->registerJs("var options = ".json_encode($options).";", View::POS_END, 'my-options');
+$this->registerJs(
+ "$('#myButton').on('click', function() { alert('ボタンがクリックされました'); });",
+ View::POS_READY,
+ 'my-button-handler'
+);
```
-最初の引数は、ページに挿入したい実際の JS コードです。
-二番目の引数は、スクリプトがページのどの場所に挿入されるべきかを決定します。
+最初の引数は、ページに挿入したい実際の JS コードです。これが `