[ja] cakephp#3702, cakephp#3703 and 2-8-migration-guide.rst

ja/appendices/2-8-migration-guide.rst

@@ -61,6 +61,8 @@ Hash
 - マジックメソッドで、カスタム検索タイプがサポートされるようになりました。例えば、モデルで
   ``find(‘published’)`` が実装されている場合、マジックメソッドインターフェースによって
   ``findPublishedBy`` や ``findPublishedByAuthorId`` が使用できます。
+- find の検索条件に ``IN`` と ``NOT IN`` 演算子が使用できるようになりました。
+  これは、3.x との前方互換性のより高い find の表現が可能になります。
 
 Validation
 ==========

ja/contributing/cakephp-coding-conventions.rst

@@ -38,12 +38,33 @@ CakePHP の開発者は以下のコーディング規約を使います。
     $booleanVariable = true;
     $stringVariable = '大鹿';
     if ($booleanVariable) {
-        echo '真偽値はtrueです';
+        echo '真偽値は true です';
         if ($stringVariable === '大鹿') {
             echo '大鹿に遭遇しました';
         }
     }
 
+あなたが、複数行にわたる関数呼び出しを使用している場合、以下のガイドラインに従ってください。
+
+*  複数行にわたる関数呼び出しのカッコを開く時には、行末になければなりません。
+*  複数行にわたる関数呼び出しの中の１行ごとに１引数のみ許可します。
+*  複数行にわたる関数呼び出しの閉じカッコは、１行にしなければなりません。
+
+例として、以下の形式が使用されていた場合、 ::
+
+    $matches = array_intersect_key($this->_listeners,
+                    array_flip(preg_grep($matchPattern,
+                        array_keys($this->_listeners), 0)));
+
+代わりに以下を使用してください。 ::
+
+    $matches = array_intersect_key(
+        $this->_listeners,
+        array_flip(
+            preg_grep($matchPattern, array_keys($this->_listeners), 0)
+        )
+    );
+
 行の長さ
 =========
 

ja/core-libraries/helpers/form.rst

@@ -1545,10 +1545,12 @@ file タイプの入力フィールドを生成::
     HTML のリンクを作りますが、その URL へのアクセス方法を POST にします。
     ブラウザで JavaScript を有効にする場合はこれが必要です。
 
-    このメソッドは ``<form>`` 要素を作成します。そのため、この
-    メソッドを既存のフォームの中では使わないでください。その代わり、
-    :php:meth:`FormHelper::submit()` を使って submit ボタンを追加
-    してください。
+    このメソッドは ``<form>`` 要素を作成します。もし、このメソッドを、既存のフォームの中で
+    使用したい場合、 新しいフォームがそのフォームの外に作成されるようにするために ``inline``
+    や ``block`` オプションを使用しなければなりません。
+
+    もし、あなたのフォームを投稿するボタンを探しているなら、代わりに
+    :php:meth:`FormHelper::submit()` を使用してください。
 
     .. versionchanged:: 2.3
         ``method`` オプションが追加されました。