From b03249b93b0065b52d100bc10839db9d511ded7f Mon Sep 17 00:00:00 2001
From: kazuya kawaguchi <kawakazu80@gmail.com>
Date: Sun, 9 Apr 2017 00:09:06 +0900
Subject: [PATCH 1/2] pick up from #760

---
 docs/ja/workflow/production.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ja/workflow/production.md b/docs/ja/workflow/production.md
index e92a5b968..b229cacdc 100644
--- a/docs/ja/workflow/production.md
+++ b/docs/ja/workflow/production.md
@@ -24,7 +24,7 @@ module.exports = {
         warnings: false
       }
     }),
-    // 発生回数別にモジュールIDを最適化します
+    // Webpack 1 のみ - 発生回数別にモジュールIDを最適化します
     new webpack.optimize.OccurenceOrderPlugin()
   ]
 }

From 29431ad1cf388aa7bde83967f9b152ba770534a0 Mon Sep 17 00:00:00 2001
From: kazuya kawaguchi <kawakazu80@gmail.com>
Date: Sun, 9 Apr 2017 00:51:11 +0900
Subject: [PATCH 2/2] tweak ja translations

---
 docs/ja/README.md                        | 21 +++++-----
 docs/ja/SUMMARY.md                       |  2 +-
 docs/ja/configurations/advanced.md       | 12 +++---
 docs/ja/configurations/asset-url.md      |  5 +--
 docs/ja/configurations/custom-blocks.md  |  2 +-
 docs/ja/configurations/extract-css.md    |  2 +-
 docs/ja/configurations/pre-processors.md |  8 ++--
 docs/ja/features/css-modules.md          | 14 +++----
 docs/ja/features/es2015.md               | 10 ++---
 docs/ja/features/postcss.md              | 11 +++--
 docs/ja/features/scoped-css.md           |  2 +-
 docs/ja/options.md                       | 53 ++++++++++++------------
 docs/ja/start/setup.md                   |  2 +-
 docs/ja/start/spec.md                    | 36 +++++++---------
 docs/ja/workflow/linting.md              | 16 +++----
 docs/ja/workflow/production.md           | 13 +++---
 docs/ja/workflow/testing-with-mocks.md   | 12 +++---
 docs/ja/workflow/testing.md              | 10 ++---
 18 files changed, 109 insertions(+), 122 deletions(-)

diff --git a/docs/ja/README.md b/docs/ja/README.md
index c80aa4030..08504db53 100644
--- a/docs/ja/README.md
+++ b/docs/ja/README.md
@@ -6,13 +6,12 @@
 
 ![screenshot](http://blog.evanyou.me/images/vue-component.png)
 
-`vue-loader` によって多くのクールな機能が提供されます：
+`vue-loader` によって多くのクールな機能が提供されます:
 
-- デフォルトで ES2015 が有効；
-- `<style>` には SASS、 `<template>` には Jade など、Vue コンポーネントの各パーツに他の Webpack の loader が使用可能；
- カスタム loader チェーンを適用できる .vue ファイルのカスタムセクションを追加可能；
-- `<style>` と `<template>` で参照される静的なアセットをモジュールの依存として扱い、Webpack の loader で処理可能；
-- 各コンポーネントで scoped CSS をシミュレートすることが可能；
+- デフォルトで ES2015 が有効
+- `<style>` には SASS、 `<template>` には Jade など、Vue コンポーネントの各パーツに他の Webpack の loader が使用可能、カスタム loader チェーンを適用できる .vue ファイルのカスタムセクションを追加可能
+- `<style>` と `<template>` で参照される静的なアセットをモジュールの依存として扱い、Webpack の loader で処理可能
+- 各コンポーネントで scoped CSS をシミュレートすることが可能
 - 開発時のコンポーネントのホットリロードをサポート
 
 つまり、Webpack と `vue-loader` の組み合わせは Vue.js アプリケーションを作成するための、現代的で柔軟かつとても強力なフロントエンドワークフローを実現することが可能になります。
@@ -29,10 +28,10 @@
 
 しかし Webpack はそれ以上のことが出来ます。 "loader" を用いることで、最終的なバンドルしたファイルを出力する前に Webpack に様々な方法で全てのタイプのファイルを変換できるように設定することが出来ます。いくつかの例をあげると：
 
-- ES2015、CoffeeScript、TypeScript のモジュールをプレーンな ES5 の CommonJS モジュールにトランスパイル；
-- オプションでコンパイルを行う前にソースコードを linter に通すことが可能；
-- Jade テンプレートをプレーンな HTML にトランスパイルし、JavaScript の文字列として展開；
-- SASS ファイルをプレーンな CSS にトランスパイルし、`<style>` タグとして挿入する JavaScript スニペットに変換；
-- HTML または CSS で参照されるイメージファイルを処理し、パスの設定に基づいた目的の場所に移動し、md5 ハッシュを使用して名前付け；
+- ES2015、CoffeeScript、TypeScript のモジュールをプレーンな ES5 の CommonJS モジュールにトランスパイル
+- オプションでコンパイルを行う前にソースコードを linter に通すことが可能
+- Jade テンプレートをプレーンな HTML にトランスパイルし、JavaScript の文字列として展開
+- SASS ファイルをプレーンな CSS にトランスパイルし、`<style>` タグとして挿入する JavaScript スニペットに変換
+- HTML または CSS で参照されるイメージファイルを処理し、パスの設定に基づいた目的の場所に移動し、md5 ハッシュを使用して名前付け
 
 Webpack は非常に強力です。どのように動作するか理解すれば、フロントエンド開発のワークフローを劇的に向上させることが出来ます。欠点としては冗長で複雑な構成です。しかし、このガイドでは Vue.js と `vue-loader` での Webpack を使用する際に一般的な問題の解決策を見つけることができるはずです。
diff --git a/docs/ja/SUMMARY.md b/docs/ja/SUMMARY.md
index f489b56ec..30141944d 100644
--- a/docs/ja/SUMMARY.md
+++ b/docs/ja/SUMMARY.md
@@ -15,7 +15,7 @@
   - [カスタムブロック](configurations/custom-blocks.md)
 - ワークフロー
   - [プロダクションビルド](workflow/production.md)
-  - [Linting](workflow/linting.md)
+  - [リント](workflow/linting.md)
   - [テスト](workflow/testing.md)
   - [モックを使用したテスト](workflow/testing-with-mocks.md)
 - [オプションリファレンス](options.md)
diff --git a/docs/ja/configurations/advanced.md b/docs/ja/configurations/advanced.md
index 6b534b9cc..13ef1d20b 100644
--- a/docs/ja/configurations/advanced.md
+++ b/docs/ja/configurations/advanced.md
@@ -1,14 +1,14 @@
 # 高度な loader の設定
 
-時折こうしたくなるかもしれません：
+時折こうしたくなるかもしれません:
 
-1. `vue-loader` が推測するのではなく、カスタム loader の文字列を言語に適用する。
-2. デフォルトの言語の組み込み loader の設定の上書き。
-3. 特定の言語ブロックをカスタム loader で前処理か後処理をする。
+1. `vue-loader` が推測するのではなく、カスタム loader の文字列を言語に適用する
+2. デフォルトの言語の組み込み loader の設定の上書き
+3. 特定の言語ブロックをカスタム loader で前処理か後処理をする
 
-そうするためには、`vue-loader` に `loaders` オプションを指定してください：
+そうするためには、`vue-loader` に `loaders` オプションを指定してください:
 
-> メモ： `preLoaders` と `postLoaders` は 10.3.0 以上でのみサポートされます
+> メモ: `preLoaders` と `postLoaders` は 10.3.0 以上でのみサポートされます
 
 ### Webpack 2.x
 
diff --git a/docs/ja/configurations/asset-url.md b/docs/ja/configurations/asset-url.md
index 7a06878eb..18cc121e5 100644
--- a/docs/ja/configurations/asset-url.md
+++ b/docs/ja/configurations/asset-url.md
@@ -8,15 +8,14 @@
 <img src="../image.png">
 ```
 
-このようにコンパイルされます：
+このようにコンパイルされます:
 
 ``` js
 createElement('img', { attrs: { src: require('../image.png') }})
 ```
 もちろん `.png` ファイルは JavaScript のファイルではありません。[file-loader](https://github.com/webpack/file-loader) または [url-loader](https://github.com/webpack/url-loader) を使用して Webpack を設定する必要があります。`vue-cli` でスキャフォールドされたプロジェクトでは同じような設定がなされています。
 
-利点の全ては次の通りです：
+利点の全ては次の通りです:
 
 1. `file-loader` はアセットファイルのコピー先や配置先を制定したり、バージョンハッシュを利用してキャッシングを改善する方法を指定する事が出来ます。さらに、これは、単に**あなたの `* .vue` ファイルの隣にイメージを置くことができ、配備するURLを心配するのではなくフォルダ構造に基づいて相対パスを使用する**ことを意味します。
-
 2. `url-loader` は、指定されたしきい値よりも小さい場合、条件付きでファイルを base-64 データ URL としてインライン化することができます。これにより、単純なファイルに対する HTTP リクエストの量を減らすことができます。 ファイルがしきい値より大きい場合、自動的に `file-loader` にフォールバックします。
diff --git a/docs/ja/configurations/custom-blocks.md b/docs/ja/configurations/custom-blocks.md
index 9b56edba1..7c4a7ece8 100644
--- a/docs/ja/configurations/custom-blocks.md
+++ b/docs/ja/configurations/custom-blocks.md
@@ -8,7 +8,7 @@
 
 ## 単一ドキュメントファイルの例
 
-全ての `<docs>` カスタムブロックを一つのドキュメントファイルに展開する例を示します：
+全ての `<docs>` カスタムブロックを一つのドキュメントファイルに展開する例を示します:
 
 #### component.vue
 
diff --git a/docs/ja/configurations/extract-css.md b/docs/ja/configurations/extract-css.md
index 8696a1624..63956ba34 100644
--- a/docs/ja/configurations/extract-css.md
+++ b/docs/ja/configurations/extract-css.md
@@ -1,6 +1,6 @@
 # CSS を単一のファイルに抽出する
 
-すべての Vue コンポーネントで処理されたすべての CSS を1つの CSS ファイルに抽出する例：
+すべての Vue コンポーネントで処理されたすべての CSS を 1 つの CSS ファイルに抽出する例:
 
 ### Webpack 2.x
 
diff --git a/docs/ja/configurations/pre-processors.md b/docs/ja/configurations/pre-processors.md
index 04576ad65..1b72c8358 100644
--- a/docs/ja/configurations/pre-processors.md
+++ b/docs/ja/configurations/pre-processors.md
@@ -4,7 +4,7 @@ Webpack において、全てのプリプロセッサは対応する loader を
 
 ### CSS
 
-例えば、SASS で `<style>` タグをコンパイルしましょう：
+例えば、SASS で `<style>` タグをコンパイルしましょう:
 
 ``` bash
 npm install sass-loader node-sass --save-dev
@@ -39,7 +39,7 @@ vue-loader を構成する方法の詳細については、[高度な loader の
 
 ### JavaScript
 
-全てのVueコンポーネントのJavaScriptはデフォルトで `babel-loader` によって処理されます。しかしもちろんそれは変更することが可能です：
+全ての Vue コンポーネントの JavaScript はデフォルトで `babel-loader` によって処理されます。しかしもちろんそれは変更することが可能です:
 
 ``` bash
 npm install coffee-loader --save-dev
@@ -53,7 +53,7 @@ npm install coffee-loader --save-dev
 
 ### テンプレート
 
-`pug-loader` のようなほとんどのWebpackテンプレート loader は、コンパイルされたHTML文字列の代わりにテンプレート関数を返すので、template の処理は少し異なります。`pug-loader` を使う代わりに、オリジナルの `pug` をインストールをするだけです：
+`pug-loader` のようなほとんどのWebpackテンプレート loader は、コンパイルされたHTML文字列の代わりにテンプレート関数を返すので、template の処理は少し異なります。`pug-loader` を使う代わりに、オリジナルの `pug` をインストールをするだけです:
 
 ``` bash
 npm install pug --save-dev
@@ -70,7 +70,7 @@ div
 
 ### インラインローダーリクエスト
 
-`lang` 属性で [Webpack loader requests](https://webpack.github.io/docs/loaders.html#introduction) を使用することが可能です：
+`lang` 属性で [Webpack loader requests](https://webpack.github.io/docs/loaders.html#introduction) を使用することが可能です:
 
 ``` html
 <style lang="sass?outputStyle=expanded">
diff --git a/docs/ja/features/css-modules.md b/docs/ja/features/css-modules.md
index 8dd753f7b..380bc2839 100644
--- a/docs/ja/features/css-modules.md
+++ b/docs/ja/features/css-modules.md
@@ -6,7 +6,7 @@
 
 ### 使い方
 
-`module` 属性を `<style>` タグに追加します：
+`module` 属性を `<style>` タグに追加します:
 
 ``` html
 <style module>
@@ -29,7 +29,7 @@
 </template>
 ```
 
-これは算出プロパティなので、`:class` の オブジェクト/配列 構文でも動作します：
+これは算出プロパティなので、`:class` の オブジェクト / 配列構文でも動作します:
 
 ``` html
 <template>
@@ -44,7 +44,7 @@
 </template>
 ```
 
-そして JavaScript からもアクセス可能です：
+そして JavaScript からもアクセス可能です:
 
 ``` html
 <script>
@@ -60,9 +60,9 @@ export default {
 
 [CSS Modules spec](https://github.com/css-modules/css-modules) を参照してください。モードの詳細については [global exceptions](https://github.com/css-modules/css-modules#exceptions) と [composition](https://github.com/css-modules/css-modules#composition)を参照してください。
 
-### カスタム代入
+### カスタム注入名
 
-単一の `*.vue` コンポーネントは複数の `<style>` タグを持つことが出来ます。注入されたスタイルが互いに上書きするのを避けるために、 `module`属性に値を与えることによって、注入された計算されたプロパティの名前をカスタマイズすることができます：
+単一の `*.vue` コンポーネントは複数の `<style>` タグを持つことが出来ます。注入されたスタイルが互いに上書きするのを避けるために、 `module`属性に値を与えることによって、注入された計算されたプロパティの名前をカスタマイズすることができます:
 
 ``` html
 <style module="a">
@@ -76,7 +76,7 @@ export default {
 
 ### `css-loader` クエリの設定
 
-CSS モジュールは [css-loader](https://github.com/webpack/css-loader) によって処理されます。`<style module>` では `css-loader` に使われるデフォルトのクエリは次のようになります。
+CSS モジュールは [css-loader](https://github.com/webpack/css-loader) によって処理されます。`<style module>` では `css-loader` に使われるデフォルトのクエリは次のようになります:
 
 ``` js
 {
@@ -86,7 +86,7 @@ CSS モジュールは [css-loader](https://github.com/webpack/css-loader) に
 }
 ```
 
-vue-loader の `cssModules`オプションを使って` css-loader`に追加のクエリオプションを提供することができます：
+vue-loader の `cssModules`オプションを使って` css-loader`に追加のクエリオプションを提供することができます:
 
 ``` js
 // webpack 1
diff --git a/docs/ja/features/es2015.md b/docs/ja/features/es2015.md
index 521c24feb..a27463230 100644
--- a/docs/ja/features/es2015.md
+++ b/docs/ja/features/es2015.md
@@ -1,11 +1,11 @@
 # ES2015
 
-同一プロジェクト内で `babel-loader` か `buble-loader` を検出したとき、全ての `*.vue` ファイルの `<script>` タグを処理するためにそれらを使用し Vue コンポーネント内で ES2015 を使用できるようにします。もしあなたがまだ新しい言語機能を手に入れていないのであれば、手に入れるべきです。いくつかのよい学習リソースはこちら：
+同一プロジェクト内で `babel-loader` か `buble-loader` を検出したとき、全ての `*.vue` ファイルの `<script>` タグを処理するためにそれらを使用し Vue コンポーネント内で ES2015 を使用できるようにします。もしあなたがまだ新しい言語機能を手に入れていないのであれば、学ぶべきです。いくつかのよい学習リソースはこちら:
 - [Babel - Learn ES2015](https://babeljs.io/docs/learn-es2015/)
 - [ES6 Features](https://github.com/lukehoban/es6features)
 - [Exploring ES6 (book)](https://leanpub.com/exploring-es6)
 
-他の Vue コンポーネントを読み込む際の典型的なパターンはこちらです。
+他の Vue コンポーネントを読み込む際の典型的なパターンはこちらです:
 
 ``` html
 <script>
@@ -21,11 +21,11 @@ export default {
 </script>
 ```
 
-ここでは ES2015 のオブジェクトリテラルを使用して子コンポーネントを定義しています。`{ ComponentA }` は `{ ComponentA: ComponentA }` の簡略形です。 Vue はオートでキーを `component-a` に変換し、インポートされたコンポーネントをテンプレート内で `<component-a>` として使用することが出来ます。
+ここでは ES2015 のオブジェクトリテラルを使用して子コンポーネントを定義しています。`{ ComponentA }` は `{ ComponentA: ComponentA }` の簡略形です。 Vue は自動でキーを `component-a` に変換し、インポートされたコンポーネントをテンプレート内で `<component-a>` として使用することが出来ます。
 
 ### テンプレート内のES2015
 
-`*.vue` ファイル内の `<template>` は JavaScript の render 関数にコンパイルされ[Buble](https://buble.surge.sh/guide/) のカスタムビルドで処理され ES2015 の機能をサポートします。これにより [Object shorthand properties](https://buble.surge.sh/guide/#object-shorthand-methods-and-properties-transforms-concisemethodproperty-) と[算出プロパティ](https://buble.surge.sh/guide/#computed-properties-transforms-computedproperty-)などの機能が使用できるようになります。
+`*.vue` ファイル内の `<template>` は JavaScript の render 関数にコンパイルされ[Buble](https://buble.surge.sh/guide/) のカスタムビルドで処理され ES2015 の機能をサポートします。これにより [Object shorthand properties](https://buble.surge.sh/guide/#object-shorthand-methods-and-properties-transforms-concisemethodproperty-) と[算出プロパティ](https://buble.surge.sh/guide/#computed-properties-transforms-computedproperty-)などの機能が使用できるようになります:
 
 ``` html
 <div :class="[{ active: active }, isButton ? prefix + '-button' : null]">
@@ -37,7 +37,7 @@ export default {
 <div :class="{ active, [`${prefix}-button`]: isButton }">
 ```
 
-**vue@^2.1.0 のみ利用可能:** `v-for` かスコープ付きスロットを使用することで、構造化されたパラメータを使用することが出来ます：
+**vue@^2.1.0 のみ利用可能:** `v-for` かスコープ付きスロットを使用することで、構造化されたパラメータを使用することが出来ます:
 
 ``` html
 <li v-for="{ id, text } in items">
diff --git a/docs/ja/features/postcss.md b/docs/ja/features/postcss.md
index d8a54ee68..3ae7d33e7 100644
--- a/docs/ja/features/postcss.md
+++ b/docs/ja/features/postcss.md
@@ -4,7 +4,7 @@
 
 ## 設定ファイルの使用
 
-バージョン 11.0 以降、 `vue-loader` は [`postcss-loader`](https://github.com/postcss/postcss-loader#usage) でサポートされているものと同じ PostCss の設定ファイルのオートロードをサポートします：
+バージョン 11.0 以降、 `vue-loader` は [`postcss-loader`](https://github.com/postcss/postcss-loader#usage) でサポートされているものと同じ PostCss の設定ファイルのオートロードをサポートします:
 
 - `postcss.config.js`
 - `.postcssrc`
@@ -16,7 +16,7 @@
 
 あるいは、 `vue-loader` の `postcss` オプションを使用して `*.vue` ファイル用の postcss の設定を指定することが出来ます。
 
-Webpack 1.x の例：
+Webpack 1.x の例:
 
 ``` js
 // webpack.config.js
@@ -52,11 +52,10 @@ module.exports = {
 }
 ```
 
-加えてpluginの配列を提供し、`postcss` オプションは以下も受け入れます：
+加えて plugin の配列を提供し、`postcss` オプションは以下も受け入れます
 
-- プラグインの配列を返す関数；
-
-- PostCSSプロセッサに渡すオプションを含むオブジェクト。これは、カスタム parser/stringifiers に依存するPostCSSプロジェクトを使用している場合に便利です。
+- プラグインの配列を返す関数
+- PostCSSプロセッサに渡すオプションを含むオブジェクト。これは、カスタム parser/stringifiers に依存するPostCSSプロジェクトを使用している場合に便利です:
 
   ``` js
   postcss: {
diff --git a/docs/ja/features/scoped-css.md b/docs/ja/features/scoped-css.md
index 75997cc10..f58728e47 100644
--- a/docs/ja/features/scoped-css.md
+++ b/docs/ja/features/scoped-css.md
@@ -1,6 +1,6 @@
 # スコープ付き CSS
 
-`scoped` 属性をもつ `<style>` タグを利用するとき、その CSS は現在のコンポーネントの要素にのみ適用されます。これは Shadow DOM のスタイルのカプセル化に似ています。いくつか注意点がありますが、polyfill は必要ありません。PostCSS を使用して以下を変換することによって実現しています。
+`scoped` 属性をもつ `<style>` タグを利用するとき、その CSS は現在のコンポーネントの要素にのみ適用されます。これは Shadow DOM のスタイルのカプセル化に似ています。いくつか注意点がありますが、polyfill は必要ありません。PostCSS を使用して以下を変換することによって実現しています:
 
 ``` html
 <style scoped>
diff --git a/docs/ja/options.md b/docs/ja/options.md
index 413551db4..d9ade93c1 100644
--- a/docs/ja/options.md
+++ b/docs/ja/options.md
@@ -1,8 +1,8 @@
 # オプションリファレンス
 
-## Webpack 1と2の使い方の違い
+## Webpack 1 と 2 の使い方の違い
 
-Webpack 2 の場合：オプションを loader ルールに直接渡します。
+Webpack 2 の場合: オプションを loader ルールに直接渡します。
 
 ``` js
 module.exports = {
@@ -21,7 +21,7 @@ module.exports = {
 }
 ```
 
-Webpack 1.x の場合： Webpack の設定のルートに `vue` ブロックを追加します。
+Webpack 1.x の場合: Webpack の設定のルートに `vue` ブロックを追加します。
 
 ``` js
 module.exports = {
@@ -34,15 +34,15 @@ module.exports = {
 
 ### loaders
 
-- 型： `{ [lang: string]: string }`
+- 型: `{ [lang: string]: string }`
 
-  `* .vue` ファイル内の言語ブロックに使用されるデフォルトの loader を上書きする Webpack loader を指定するオブジェクト。キーは指定されている場合、言語ブロックの `lang` 属性に対応します。各タイプのデフォルトの `lang` は次のとおりです：
+  `* .vue` ファイル内の言語ブロックに使用されるデフォルトの loader を上書きする Webpack loader を指定するオブジェクト。キーは指定されている場合、言語ブロックの `lang` 属性に対応します。各タイプのデフォルトの `lang` は次のとおりです:
 
   - `<template>`: `html`
   - `<script>`: `js`
   - `<style>`: `css`
 
-  たとえば、`babel-loader` と `eslint-loader` を使ってすべての `<script>` ブロックを処理するには：
+  たとえば、`babel-loader` と `eslint-loader` を使ってすべての `<script>` ブロックを処理するには:
 
   ``` js
   // Webpack 2.x config
@@ -63,27 +63,26 @@ module.exports = {
 
 ### preLoaders
 
-- 型： `{ [lang: string]: string }`
+- 型: `{ [lang: string]: string }`
 - 10.3.0 以上でサポートされます。
 
   config 形式は `loaders` と同じですが、`preLoaders` はデフォルト loader の前に対応する言語ブロックに適用されます。これを使用して言語ブロックを前処理することができます。一般的な使用例としては、i18n のビルド時です。
 
 ### postLoaders
 
-- 型：`{ [lang: string]: string }`
+- 型: `{ [lang: string]: string }`
 - 10.3.0 以上でサポートされます。
 
-  config 形式は `loaders` と同じですが、` postLoaders` はデフォルト loader の後に適用されます。これを使用して言語ブロックを後処理することができます。ただしこれは少し複雑になります：
+  config 形式は `loaders` と同じですが、` postLoaders` はデフォルト loader の後に適用されます。これを使用して言語ブロックを後処理することができます。ただしこれは少し複雑になります:
 
   - `html` の場合、デフォルトの loader によって返される結果は、コンパイルされた JavaScript レンダリング関数コードになります。
-
   - `css` の場合、結果は` vue-style-loader` によって返されます。これはほとんどの場合特に有用ではありません。postcss プラグインを使用する方が良いでしょう。
 
 ### postcss
 
-  > メモ: 11.0.0 以上では代わりにPostCSSの設定ファイル推奨されています。[使用法は `postcss-loader` と同じです](https://github.com/postcss/postcss-loader#usage)。
+  > メモ: 11.0.0 以上では代わりに PostCSS の設定ファイル推奨されています。[使用法は `postcss-loader` と同じです](https://github.com/postcss/postcss-loader#usage)。
 
-- 型： `Array` もしくは `Function` か `Object`
+- 型: `Array` もしくは `Function` か `Object`
 
   カスタムした PostCSS プラグインを `*.vue` ファイル内の CSS に適用するよう指定します。もし関数を使用しているなら、この関数は同じ loader のコンテキストを使用して呼び出され、プラグインの配列を返す必要があります。
 
@@ -114,46 +113,46 @@ module.exports = {
 
 ### cssSourceMap
 
-- 型： `Boolean`
+- 型: `Boolean`
 - デフォルト: `true`
 
   CSS のソースマップを有効にするかどうか。これを無効にすると、`css-loader` の相対パス関連のバグを避けることができ、ビルドを少し早くすることができます。
 
-  注意： もしメインの Webpack の設定に `devtool` オプションが存在しないければオートで `false` にセットされます。
+  注意: もしメインの Webpack の設定に `devtool` オプションが存在しないければオートで `false` にセットされます。
 
 ### esModule
 
-- 型： `Boolean`
-- デフォルト： `undefined`
+- 型: `Boolean`
+- デフォルト: `undefined`
 
   esModule 互換コードを発行するかどうか。デフォルトの vue-loader のデフォルトの出力は `module.exports = ....` のような commonjs 形式で発行します。 `esModule` が true にセットされているとき、デフォルトの出力は `exports.__esModule = true; exports = ...` にトランスパイルされます。TypeScript のような Babel 以外の transpiler との相互運用に役立ちます。
 
 ### preserveWhitespace
 
-- 型： `Boolean`
-- デフォルト： `true`
+- 型: `Boolean`
+- デフォルトx: `true`
 
   もし `false` に設定されていたら、テンプレート内の HTML タグ間の空白は無視されます。
 
 ### transformToRequire
 
-- 型： `{ [tag: string]: string | Array<string> }`
-- デフォルト： `{ img: 'src', image: 'xlink:href' }`
+- 型: `{ [tag: string]: string | Array<string> }`
+- デフォルト: `{ img: 'src', image: 'xlink:href' }`
 
-  テンプレートのコンパイル中、コンパイラは `src` の URL のような特定の属性を `require` 呼び出しに変換することができます。これによりターゲットの asset を Webpack が処理できるようになります。デフォルトの設定は `<img>` タグの `src` 属性と SVG の `<image>` タグの `xlink：href` 属性を変換します。
+  テンプレートのコンパイル中、コンパイラは `src` の URL のような特定の属性を `require` 呼び出しに変換することができます。これによりターゲットの asset を Webpack が処理できるようになります。デフォルトの設定は `<img>` タグの `src` 属性と SVG の `<image>` タグの `xlink:href` 属性を変換します。
 
 ### buble
 
-  型： `Object`
-  デフォルト： `{}`
+  型: `Object`
+  デフォルト: `{}`
 
-  `bubble-loader`（存在する場合）のオプションとテンプレートレンダリング関数のための buble のコンパイルパスを設定します。
+  `bubble-loader`(存在する場合)のオプションとテンプレートレンダリング関数のための buble のコンパイルパスを設定します。
 
-  > バージョンメモ： 9.x では、テンプレート式は削除された `templateBuble` オプションによって別々に設定されます。
+  > バージョンメモ: 9.x では、テンプレート式は削除された `templateBuble` オプションによって別々に設定されます。
 
-  このテンプレートレンダリング関数のコンパイルでは、特別な変換 `stripWidth` （デフォルトで有効）がサポートされ、生成されたレンダリング関数で `with` の使用法が削除され、strict-mode に準拠します。
+  このテンプレートレンダリング関数のコンパイルでは、特別な変換 `stripWidth` (デフォルトで有効)がサポートされ、生成されたレンダリング関数で `with` の使用法が削除され、strict-mode に準拠します。
 
-  設定の例：
+  設定の例:
 
   ``` js
   // webpack 1
diff --git a/docs/ja/start/setup.md b/docs/ja/start/setup.md
index 786b22878..29fc8d877 100644
--- a/docs/ja/start/setup.md
+++ b/docs/ja/start/setup.md
@@ -2,7 +2,7 @@
 
 ### `vue-cli` の使用
 
-`vue-loader` を使用するプロジェクトの足場作りは `vue-cli` を使用することをお薦めします：
+`vue-loader` を使用するプロジェクトの足場作り (scaffolding) には `vue-cli` を使用することをお薦めします:
 
 ``` bash
 npm install -g vue-cli
diff --git a/docs/ja/start/spec.md b/docs/ja/start/spec.md
index 8bca22041..092a9a2ab 100644
--- a/docs/ja/start/spec.md
+++ b/docs/ja/start/spec.md
@@ -1,6 +1,6 @@
 # Vue Component の仕様
 
-`*.vue` ファイルは HTML ライクな構文を使用して Vue コンポーネントを記述するカスタムファイルフォーマットです。各 `*.vue` ファイルは `<template>`、`<script>`、`<style>` の三つのトップレベル言語のブロックで構成されています。
+`*.vue` ファイルは HTML のような構文を使用して Vue コンポーネントを記述するカスタムファイルフォーマットです。各 `*.vue` ファイルは `<template>`、`<script>`、`<style>` の三つのトップレベル言語のブロックで構成されています。
 
 ``` html
 <template>
@@ -34,7 +34,7 @@ export default {
 
 ``` html
 <style lang="sass">
-  /* write SASS! */
+  /* SASS で書きます! */
 </style>
 ```
 詳細は [プリプロセッサの仕様](../configurations/pre-processors.md) で確認することが出来ます。
@@ -44,30 +44,22 @@ export default {
 #### `<template>`
 
 - デフォルトの言語は `html`
-
-- それぞれの `*.vue` ファイルは最大で一つの `<template>` ブロックを含みます。
-
-- 内容は文字列に展開され、コンパイルされた Vue コンポーネントの `template` オプションで使用されます。
+- それぞれの `*.vue` ファイルは最大で一つの `<template>` ブロックを含みます
+- 内容は文字列に展開され、コンパイルされた Vue コンポーネントの `template` オプションで使用されます
 
 #### `<script>`
 
 - デフォルトの言語は `js`（`babel-loader` や `buble-loader` が検出される場合、自動的にES2015がサポートされる）
-
-- それぞれの `*.vue` ファイルは最大で一つの `<script>` ブロックを含みます。
-
-- スクリプトは CommonJS のように処理されます（ Webpack 経由でバンドルされた通常の `.js` モジュールと同じです）。つまり他の依存関係を `recuire()` することができます。そして ES2015 がサポートされ、`import` と `export` 構文を使用することが出来ます。
-
-- スクリプトは Vue.js コンポーネントのオプションオブジェクトをエクスポートする必要があります。 'Vue.extend()' によって拡張されたコンストラクタもエクスポートすることが可能ですが、プレーンなオブジェクトが好ましいです。
+- それぞれの `*.vue` ファイルは最大で一つの `<script>` ブロックを含みます
+- スクリプトは CommonJS のように処理されます（ Webpack 経由でバンドルされた通常の `.js` モジュールと同じです）。つまり他の依存関係を `recuire()` することができます。そして ES2015 がサポートされ、`import` と `export` 構文を使用することが出来ます
+- スクリプトは Vue.js コンポーネントのオプションオブジェクトをエクスポートする必要があります。 `Vue.extend()` によって拡張されたコンストラクタもエクスポートすることが可能ですが、プレーンなオブジェクトが好ましいです
 
 #### `<style>`
 
-- デフォルトの言語は `css`。
-
-- 複数の `<style>` タグは単一の `*.vue` ファイルでサポートされます。
-
-- `<style>` タグは `scoped` か `module` （詳しくは [Scoped CSS](../features/scoped-css.md) と [CSS Modules](../features/css-modules.md) をみてください）を使用してコンポーネントにスタイルをカプセル化する事が出来ます。異なるカプセルモードをもつ複数の `<style>` タグは同じコンポーネント内で混在させることが出来ます。
-
-- デフォルトではコンテンツは `style-loader` を使用して実際の `<style>` タグとして抽出され、ドキュメントの `<head>` に動的に挿入されます。また、[すべてのコンポーネントのすべてのスタイルが単一のCSSファイルに抽出されるようにWebpackを設定する](../configurations/extract-css.md)こともできます。
+- デフォルトの言語は `css`
+- 複数の `<style>` タグは単一の `*.vue` ファイルでサポートされます
+- `<style>` タグは `scoped` か `module` （詳しくは [Scoped CSS](../features/scoped-css.md) と [CSS Modules](../features/css-modules.md) をみてください）を使用してコンポーネントにスタイルをカプセル化する事が出来ます。異なるカプセルモードをもつ複数の `<style>` タグは同じコンポーネント内で混在させることが出来ます
+- デフォルトではコンテンツは `style-loader` を使用して実際の `<style>` タグとして抽出され、ドキュメントの `<head>` に動的に挿入されます。また、[すべてのコンポーネントのすべてのスタイルが単一のCSSファイルに抽出されるようにWebpackを設定する](../configurations/extract-css.md)ことも出来ます
 
 ### カスタムブロック
 
@@ -79,7 +71,7 @@ export default {
 
 ### ソースのインポート
 
-もし `*.vue` コンポーネントを複数のファイルに分割したい場合は、`src` 属性を使って言語ブロック用の外部ファイルをインポートすることが出来ます。
+もし `*.vue` コンポーネントを複数のファイルに分割したい場合は、`src` 属性を使って言語ブロック用の外部ファイルをインポートすることが出来ます:
 
 ``` html
 <template src="./template.html"></template>
@@ -87,7 +79,7 @@ export default {
 <script src="./script.js"></script>
 ```
 
-`src` のインポートは CommonJS の `require()` 呼び出しと同じパス解決規則に従うことに注意してください。相対パスは `./` で始める必要があり、インストールされた NPM パッケージから直接リソースをインポートすることができます。
+`src` のインポートは CommonJS の `require()` 呼び出しと同じパス解決規則に従うことに注意してください。相対パスは `./` で始める必要があり、インストールされた NPM パッケージから直接リソースをインポートすることができます:
 
 ``` html
 <!-- インストールされた "todomvc-app-css" npm パッケージ からファイルをインポートします-->
@@ -107,4 +99,4 @@ export default {
 
 ### コメント
 
-それぞれのブロック内でそれぞれの言語のコメントシンタックスを使用することが出来る（HTML、CSS、JavaScript、Jade、etc）。最上部のコメントは HTML コメントシンタックスを使用してください： `<!-- コメントはこちら -->`
+それぞれのブロック内でそれぞれの言語のコメントシンタックスを使用することが出来る (HTML、CSS、JavaScript、Jade、etc) 。最上部のコメントは HTML コメントシンタックスを使用してください: `<!-- コメントはこちら -->`
diff --git a/docs/ja/workflow/linting.md b/docs/ja/workflow/linting.md
index b2aee5979..8f6e475e9 100644
--- a/docs/ja/workflow/linting.md
+++ b/docs/ja/workflow/linting.md
@@ -1,10 +1,10 @@
-# Linting
+# リント
 
-あなたはJavaScriptでない `*.vue` の中のコードをどうやって lint するのか疑問に思っているかも知れません。[ESLint](http://eslint.org/)を使用していると仮定します（もし使っていないのならばすべきです！）
+あなたは JavaScript でない `*.vue` の中のコードをどうやってリント (lint) するのか疑問に思っているかも知れません。[ESLint](http://eslint.org/) を使用していると仮定します(もし使っていないのならばすべきです!)
 
 `* .vue`ファイル内のJavaScriptの抽出と埋め込みをサポートする[eslint-plugin-html](https://github.com/BenoitZugmeyer/eslint-plugin-html)も同様に必要です。
 
-あなたの ESLint の設定にプラグインを含めてください：
+あなたの ESLint の設定にプラグインを含めてください:
 
 ``` json
 "plugins": [
@@ -12,13 +12,13 @@
 ]
 ```
 
-コマンドラインで次を実行してください：
+コマンドラインで次を実行してください:
 
 ``` bash
 eslint --ext js,vue MyComponent.vue
 ```
 
-別のオプションは `*.vue` ファイルが開発中に保存時されたとき、自動的に lint されるように[eslint-loader](https://github.com/MoOx/eslint-loader)を使用しています：
+別のオプションは `*.vue` ファイルが開発中に保存時されたとき、自動的にリントされるように [eslint-loader](https://github.com/MoOx/eslint-loader) を使用しています:
 
 ``` bash
 npm install eslint eslint-loader --save-dev
@@ -38,16 +38,16 @@ module.exports = {
   }
 }
 ```
-Webpack ローダーチェーンは**まずはじめに**に適用されることをご了承ください。`vue` の前に `eslint` を適用して、コンパイル前のソースコードを lint してください。
+Webpack ローダーチェーンは**まずはじめに**に適用されることをご了承ください。`vue` の前に `eslint` を適用して、コンパイル前のソースコードをリントしてください。
 
-一つ私たちが考慮する必要があるのは、NPM パッケージでリリースされているサードパーティの* .vueコンポーネントを使用することです。そのような場合には、サードパーティー製のコンポーネントを処理するために  `vue-loader` を使用したいと思いますが、それを lint したくはありません。そういうときは lint を Webpack の [preLoaders](https://webpack.github.io/docs/loaders.html#loader-order) に分けることが可能です：
+1 つ私たちが考慮する必要があるのは、NPM パッケージでリリースされているサードパーティの* .vueコンポーネントを使用することです。そのような場合には、サードパーティー製のコンポーネントを処理するために  `vue-loader` を使用したいと思いますが、それをリントしたくはありません。そういうときはリントを Webpack の [preLoaders](https://webpack.github.io/docs/loaders.html#loader-order) に分けることが可能です:
 
 ``` js
 // webpack.config.js
 module.exports = {
   // 他のオプション
   module: {
-    // lint対象はローカルの *.vue ファイルのみ
+    // リント対象はローカルの *.vue ファイルのみ
     preLoaders: [
       {
         test: /.vue$/,
diff --git a/docs/ja/workflow/production.md b/docs/ja/workflow/production.md
index b229cacdc..d20d061e4 100644
--- a/docs/ja/workflow/production.md
+++ b/docs/ja/workflow/production.md
@@ -1,11 +1,11 @@
 # プロダクションビルド
 
-プロダクション用にバンドルを構築するときは二つのことを行います：
+プロダクション用にバンドルを構築するときは 2 つのことを行います:
 
-1. アプリケーションコードを縮小します：
+1. アプリケーションコードを縮小します:
 2. [Vue.jsガイドに記載されているセットアップの説明](https://vuejs.org/guide/deployment.html) を使用して Vue.js のソースコードから全ての警告を削除します
 
-設定例を以下に示します：
+設定例を以下に示します:
 
 ``` js
 // webpack.config.js
@@ -30,10 +30,9 @@ module.exports = {
 }
 ```
 
-明らかに開発中にこの設定を使いたくないので、これにはいくつかの方法をとります：
+明らかに開発中にこの設定を使いたくないので、これにはいくつかの方法をとります:
 
-1. 環境変数に基づいて構成オブジェクトを動的に構築します；
-
-2. または、開発用と運用用の2つの Webpack 設定ファイルを使用します。[vue-hackernews-2.0](https://github.com/vuejs/vue-hackernews-2.0)に示すように、3つ目のファイルに共通のオプションをいくつか共有することもできます。
+1. 環境変数に基づいて構成オブジェクトを動的に構築します
+2. または、開発用と運用用の2つの Webpack 設定ファイルを使用します。[vue-hackernews-2.0](https://github.com/vuejs/vue-hackernews-2.0) に示すように、3 つ目のファイルに共通のオプションをいくつか共有することもできます
 
 目標を達成している限り、それはあなた次第です。
diff --git a/docs/ja/workflow/testing-with-mocks.md b/docs/ja/workflow/testing-with-mocks.md
index 7776fbef8..b14df1881 100644
--- a/docs/ja/workflow/testing-with-mocks.md
+++ b/docs/ja/workflow/testing-with-mocks.md
@@ -4,7 +4,7 @@
 
 `vue-loader` は、[inject-loader](https://github.com/plasticine/inject-loader)を使って任意の依存関係を `*.vue` コンポーネントに注入する機能を提供します。一般的な考え方としては、コンポーネントモジュールを直接インポートするのではなく、`inject-loader` を使用して、そのモジュール用の「モジュールファクトリ」関数を作成するというものです。この関数がモックのオブジェクトで呼び出されると、モックが注入されたモジュールのインスタンスが返されます。
 
-次のようなコンポーネントがあるとします：
+次のようなコンポーネントがあるとします:
 
 ``` html
 <!-- example.vue -->
@@ -26,9 +26,9 @@ export default {
 </script>
 ```
 
-モックをインポートする方法は次のとおりです：
+モックをインポートする方法は次のとおりです:
 
-> 注意: inject-loader@3.x は現在不安定です。
+> 注意: inject-loader@3.x は現在 unstable です。
 
 ``` bash
 npm install inject-loader@^2.0.0 --save-dev
@@ -39,12 +39,12 @@ npm install inject-loader@^2.0.0 --save-dev
 const ExampleInjector = require('!!vue?inject!./example.vue')
 ```
 
-注意。狂気じみた文字列を必要とします - ここではいくつかのインライン [webpack loader](https://webpack.github.io/docs/loaders.html）を使用しています。簡単な説明としては：
+注意。狂気じみた文字列を必要とします - ここではいくつかのインライン [webpack loader](https://webpack.github.io/docs/loaders.html) を使用しています。簡単な説明としては:
 
 - `!!`は "グローバル設定からすべてのローダを無効にする"ことを意味します；
 - `vue？inject！` は  "`vue` loader を使い、`？inject` クエリを渡す"ことを意味します。 これは `vue-loader` に、依存性注入モードでコンポーネントをコンパイルするように指示します。
 
-返される `ExampleInjector` は、`example.vue` モジュールのインスタンスを生成するために呼び出すことができるファクトリ関数です：
+返される `ExampleInjector` は、`example.vue` モジュールのインスタンスを生成するために呼び出すことができるファクトリ関数です:
 
 ``` js
 const ExampleWithMocks = ExampleInjector({
@@ -55,7 +55,7 @@ const ExampleWithMocks = ExampleInjector({
 })
 ```
 
-最後に、コンポーネントを通常どおりテストすることができます：
+最後に、コンポーネントを通常どおりテストすることができます:
 
 ``` js
 it('should render', () => {
diff --git a/docs/ja/workflow/testing.md b/docs/ja/workflow/testing.md
index f06007732..ccdc16da4 100644
--- a/docs/ja/workflow/testing.md
+++ b/docs/ja/workflow/testing.md
@@ -1,6 +1,6 @@
 # テスト
 
-> [webpack vue-cliテンプレート](https://github.com/vuejs-templates/webpack)には、事前に設定されたユニットテストとe2eテストの設定が用意されています。
+> [webpack vue-cli テンプレート](https://github.com/vuejs-templates/webpack)には、事前に設定された単体テストと e2e テストの設定が用意されています。
 
 `* .vue`ファイルをテストするときには、普通の CommonJS ベースのテストランナーを使うことができません。なぜならそのテストランナーは `*.vue` ファイルの扱い方を知らないからです。代わりに、Webpack + vue-loader を使用してテストファイルをバンドルします。推奨設定は [Karma](http://karma-runner.github.io/0.13/index.html) と [karma-webpack](https://github.com/webpack/karma-webpack) です。
 
@@ -43,7 +43,7 @@ module.exports = function (config) {
 }
 ```
 
-そして`test/index.js`ファイルのエントリの場合：
+そして`test/index.js`ファイルのエントリの場合:
 
 ``` js
 // test/index.js
@@ -53,7 +53,7 @@ var testsContext = require.context('.', true, /\.spec$/)
 testsContext.keys().forEach(testsContext)
 ```
 
-このエントリファイルは、単に同じフォルダ内の `.spec.js` で終わる他のすべてのファイルを必要とします。これで実際にいくつかのテストを書くことができます：
+このエントリファイルは、単に同じフォルダ内の `.spec.js` で終わる他のすべてのファイルを必要とします。これで実際にいくつかのテストを書くことができます:
 
 ``` js
 // test/component-a.spec.js
@@ -80,7 +80,7 @@ describe('a.vue', function () {
 })
 ```
 
-テストを実行するには、次の NPM スクリプトを追加します：
+テストを実行するには、次の NPM スクリプトを追加します:
 
 ``` js
 // package.json
@@ -92,7 +92,7 @@ describe('a.vue', function () {
 ...
 ```
 
-最後に実行します：
+最後に実行します:
 
 ``` bash
 npm test