Merge pull request #5760 from softark/docs-ja-2014-10-25-internals

docs/internals-ja/git-workflow.md

@@ -14,7 +14,7 @@ git clone git@github.com:YOUR-GITHUB-USERNAME/yii2.git
 Linux において、GitHub で GIT を設定するのに問題が生じたり、"Permission Denied (publickey)" のようなエラーが発生したりする場合は、
 [setup your GIT installation to work with GitHub](http://help.github.com/linux-set-up-git/) に従ってください。
 
-### 2. メインの Yii リポジトリを "upstream" という名前でリモートリポジトリとして追加する
+### 2. メインの Yii リポジトリを "upstream" という名前でリモートとして追加する
 
 Yii をクローンしたディレクトリ、すなわち "yii2" に入って、以下のコマンドを打ち込みます:
 
@@ -113,7 +113,7 @@ git push -u origin 999-name-of-your-branch-goes-here
 `-u` パラメータによって、あなたのブランチが今後は自動的に github のブランチに対してプッシュおよびプルを行うようになります。
 つまり、次回 `git push` とタイプしたときには、git は既にどこにプッシュすればよいか知っている、ということです。
 
-### 11. upstream に対してプルリクエスト ( [pull request](http://help.github.com/send-pull-requests/)) を発行する
+### 11. upstream に対して [プルリクエスト](http://help.github.com/send-pull-requests/) を発行する
 
 github 上のあなたのリポジトリに入って、"Pull Request" をクリックし、右側にあるブランチを選び、コメントボックスにもう少し詳細を記述します。
 プルリクエストを課題とリンクさせるために、プルコメントのどこかに `#999` という書式で課題番号を記載します。
@@ -126,9 +126,8 @@ github 上のあなたのリポジトリに入って、"Pull Request" をクリ
 (現在のプルリクエストが open である限りは、別の新しいプルリクエストをする必要はありません)。
 あなたのコードが受け入れられた場合は、コードはメインブランチにマージされて、次回の Yii のリリースの一部となります。
 受け入れられなくても、落胆しないでください。
-必要とする機能は人によってさまざまに異なります。
-Yii は全ての人に対して全てを提供することは出来ません。
-その場合でも、あなたのコードは github 上で公開され続けて、それを必要とする人々が参照することが出来ます。
+必要とする機能は人によってさまざまに異なりますし、Yii は全ての人に対して全てを提供することは出来ません。
+また、却下された場合でも、あなたのコードはそれを必要とする人々から参照されるように github 上で公開され続けます。
 
 ### 13. クリーンアップする
 
@@ -149,7 +148,7 @@ git push origin --delete 999-name-of-your-branch-goes-here
 
 * javascript、css または画像ファイルだけに影響する場合
 * ドキュメンテーションを更新する場合
-* 固定の文字列だけを修正する場合 (例えば、翻訳のアップデート)
+* 固定の文字列だけを修正する(例えば、翻訳をアップデートする)場合
 
 がそうです。
 

docs/internals-ja/report-an-issue.md

 課題を報告する
 ==============
 
-あなたが報告する課題(issue 問題)がより迅速に解決されるように、課題を作成するときには下記のガイドラインに従って下さい:
+あなたが報告する課題(issue)がより迅速に解決されるように、課題を作成するときには下記のガイドラインに従って下さい:
 
-* 以下の情報を提供して下さい: PHP と Yii のバージョン、オペレーティングシステムとウェブサーバのタイプ、ブラウザのタイプとバージョン;
-* 出来れば、**完全な**エラーのコールスタックを提供して下さい。問題を説明するスクリーンショットは大いに歓迎します。
+* PHP と Yii のバージョン、オペレーティングシステムとウェブサーバのタイプ、および、ブラウザのタイプとバージョンについて、情報を提供してください;
+* 出来れば、**完全な**エラーのコールスタックを提供して下さい。問題を説明するスクリーンショットは大いに歓迎されます。
 * 問題を再現する手順を記述して下さい。問題を再現するコードを提供してくださるならば、なお一層良いでしょう。
 
 **以下の場合は課題を報告しないでください**

docs/internals-ja/translation-workflow.md

@@ -32,7 +32,7 @@ Yii は国際的なアプリケーションと開発者にとって役に立つ
 --------------------
 
 ドキュメンテーションの翻訳は `docs/<original>-<language>` の下に置きます。
-ここで `<original>` は、`guide` や `internals` などの元の文書の名前であり、`<language>` は文書が翻訳先の言語のコードです。
+ここで `<original>` は、`guide` や `internals` などの元の文書の名前であり、`<language>` は文書の翻訳先の言語コードです。
 例えば、ロシア語のガイドの翻訳は `docs/guide-ru` です。
 
 初期の仕事が完了した後は、最新の翻訳以後に変更された元の文書の箇所を取得するために、`build` ディレクトリにある専用のコマンドを使うことが出来ます: