Merge pull request #592 from selvarajmas/lang-ja

Author: naokie

src/api/basic-reactivity.md

@@ -10,7 +10,7 @@
 const obj = reactive({ count: 0 })
 ```
 
-リアクティブの変換は「ディープ」で、ネストされたすべてのプロパティに影響します。[ES2015 Proxy](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Proxy) ベースの実装では、返されたプロキシは元のオブジェクトとは等しく**ありません**。元のオブジェクトに依存せず、リアクティブプロキシのみで作業することをお勧めします。
+リアクティブの変換は「ディープ」で、ネストされたすべてのプロパティに影響します。[ES2015 Proxy](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Proxy) ベースの実装では、返されたプロキシは元のオブジェクトとは等しく**ありません**。元のオブジェクトに依存せず、リアクティブプロキシのみで作業することをおすすめします。
 
 **型:**
 

src/api/directives.md

@@ -62,7 +62,7 @@
 
   このディレクティブは条件が変わったときにトランジションを引き起こします。
 
-  一緒に使ったとき、`v-if` は `v-for` よりも優先度が高くなります。これら 2 つのディレクティブを 1 つの要素で同時に使うことはお勧めしません。詳しくは [リストレンダリングのガイド](../guide/list.html#v-for-と-v-if) を参照してください。
+  一緒に使ったとき、`v-if` は `v-for` よりも優先度が高くなります。これら 2 つのディレクティブを 1 つの要素で同時に使うことはおすすめしません。詳しくは [リストレンダリングのガイド](../guide/list.html#v-for-と-v-if) を参照してください。
 
 - **参照:** [条件付きレンダリング - v-if](../guide/conditional.html#v-if)
 

src/api/instance-properties.md

@@ -28,7 +28,7 @@
 
   コンポーネントインスタンスが管理しているルート DOM 要素です。
 
-  [Fragments](../guide/migration/fragments) を使っているコンポーネントでは、`$el` は DOM 内で Vue がコンポーネントの位置を追跡するために使う DOM ノードのプレースホルダになります。DOM 要素に直接アクセスするためには、`$el` に頼る代わりに [テンプレート参照](../guide/component-template-refs.html) を使うことをお勧めします。
+  [Fragments](../guide/migration/fragments) を使っているコンポーネントでは、`$el` は DOM 内で Vue がコンポーネントの位置を追跡するために使う DOM ノードのプレースホルダになります。DOM 要素に直接アクセスするためには、`$el` に頼る代わりに [テンプレート参照](../guide/component-template-refs.html) を使うことをおすすめします。
 
 ## $options
 

src/api/options-data.md

@@ -6,9 +6,9 @@
 
 - **詳細:**
 
-  コンポーネントインスタンスのデータオブジェクトを返す関数です。 `data` では、ブラウザの API オブジェクトや prototype プロパティのような独自のステートフルな振る舞いをするオブジェクトを監視することはお勧めしません。よい考え方としては、コンポーネントのデータを表すただのプレーンオブジェクトをここで持つべきです。
+  コンポーネントインスタンスのデータオブジェクトを返す関数です。 `data` では、ブラウザの API オブジェクトや prototype プロパティのような独自のステートフルな振る舞いをするオブジェクトを監視することはおすすめしません。よい考え方としては、コンポーネントのデータを表すただのプレーンオブジェクトをここで持つべきです。
 
-  一度監視されると、ルートのデータオブジェクトにリアクティブなプロパティを追加することはできなくなります。そのため、インスタンスを作成する前に、すべてのルートレベルのリアクティブプロパティを前もって宣言しておくことをお勧めします。
+  一度監視されると、ルートのデータオブジェクトにリアクティブなプロパティを追加することはできなくなります。そのため、インスタンスを作成する前に、すべてのルートレベルのリアクティブプロパティを前もって宣言しておくことをおすすめします。
 
   インスタンスが作成された後に、`vm.$data` として元のデータオブジェクトアクセスできます。コンポーネントインスタンスは、データオブジェクトのすべてのプロパティをプロキシするため、`vm.a` は `vm.$data.a` と同じになります。
 

src/api/refs-api.md

@@ -36,7 +36,7 @@ const foo = ref<string | number>('foo') // foo の型: Ref<string | number>
 foo.value = 123 // ok!
 ```
 
-ジェネリックの型が不明な場合は、`ref` を `Ref<T>` にキャストすることをお勧めします:
+ジェネリックの型が不明な場合は、`ref` を `Ref<T>` にキャストすることをおすすめします:
 
 ```ts
 function useState<State extends string>(initial: State) {

src/cookbook/index.md

@@ -21,7 +21,7 @@
 
 このクックブックでは、一般的なユースケースや興味深いユースケースを網羅した開発者向けのサンプルを提供したり、より複雑な細かい部分を段階的にに説明していきます。私たちの目標は、単純な入門的な例を超えて、より広く適用可能な概念を示すことと、アプローチの注意点を示すことです。
 
-貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いて issue を提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くお勧めしますが、必須ではありません。
+貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いて issue を提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くおすすめしますが、必須ではありません。
 
 レシピは一般的に:
 
@@ -65,7 +65,7 @@
 
 ### このパターンを回避するケース <Badge text="任意" />
 
-このセクションは必須ではありませんが、書くことを強くお勧めします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixins のようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。
+このセクションは必須ではありませんが、書くことを強くおすすめします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixins のようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。
 
 ### 代替パターン <Badge text="必須 回避のセクションに付随する" type="warning" />
 

src/guide/a11y-basics.md

@@ -107,7 +107,7 @@ export default {
 
 
 :::tip Tip:
-レガシーな [HTML5 のセマンティック要素をサポートしていないブラウザ](https://caniuse.com/#feat=html5semantic)との互換性を最大限に高めるために、冗長なランドマークロール属性を持つランドマーク HTML 要素を使用することをお勧めします。
+レガシーな [HTML5 のセマンティック要素をサポートしていないブラウザ](https://caniuse.com/#feat=html5semantic)との互換性を最大限に高めるために、冗長なランドマークロール属性を持つランドマーク HTML 要素を使用することをおすすめします。
 :::
 
 [ランドマークについてもっと読む](https://www.w3.org/TR/wai-aria-1.2/#landmark_roles)

src/guide/component-basics.md

@@ -80,7 +80,7 @@ app.component('my-component-name', {
 
 グローバルに登録されたコンポーネントは、アプリケーション内のどのコンポーネントのテンプレートでも使うことができます。
 
-とりあえずコンポーネント登録についてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[コンポーネント登録](component-registration.md)の完全なガイドを読むことをお勧めします。
+とりあえずコンポーネント登録についてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[コンポーネント登録](component-registration.md)の完全なガイドを読むことをおすすめします。
 
 ## プロパティを用いた子コンポーネントへのデータの受け渡し
 
@@ -154,7 +154,7 @@ app.mount('#blog-posts-demo')
 
 上記では、 `v-bind` を用いて動的にプロパティを渡すことができると分かります。これはレンダリングする内容が事前に分からない場合に特に便利です。
 
-とりあえずプロパティについてはこれで以上ですが、 このページを読み終えて十分に理解できたら、後から戻ってきて[プロパティ](component-props.html)の完全なガイドを読むことをお勧めします。
+とりあえずプロパティについてはこれで以上ですが、 このページを読み終えて十分に理解できたら、後から戻ってきて[プロパティ](component-props.html)の完全なガイドを読むことをおすすめします。
 
 ## 子コンポーネントのイベントを購読する
 
@@ -349,7 +349,7 @@ app.component('custom-input', {
 })
 ```
 
-とりあえずカスタムコンポーネントイベントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[カスタムイベント](component-custom-events.md)の完全なガイドを読むことをお勧めします。
+とりあえずカスタムコンポーネントイベントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[カスタムイベント](component-custom-events.md)の完全なガイドを読むことをおすすめします。
 
 ## スロットによるコンテンツ配信
 
@@ -380,7 +380,7 @@ app.component('alert-box', {
 
 上で見た通り、コンテンツを配置したいところにプレースホルダとして `<slot>` を使います。それだけです。終わりです！
 
-とりあえずスロットについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[スロット](component-slots.md)の完全なガイドを読むことをお勧めします。
+とりあえずスロットについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[スロット](component-slots.md)の完全なガイドを読むことをおすすめします。
 
 ## 動的なコンポーネント
 
@@ -404,7 +404,7 @@ app.component('alert-box', {
 
 また、 `is` 属性を使って通常の HTML 要素を作ることもできます。
 
-とりあえず動的なコンポーネントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[動的 & 非同期コンポーネント](./component-dynamic-async.html)の完全なガイドを読むことをお勧めします。
+とりあえず動的なコンポーネントについてはこれで以上ですが、このページを読み終えて十分に理解できたら、後から戻ってきて[動的 & 非同期コンポーネント](./component-dynamic-async.html)の完全なガイドを読むことをおすすめします。
 
 ## DOM テンプレートパース時の注意
 
@@ -463,6 +463,6 @@ app.component('blog-post', {
 <blog-post post-title="hello!"></blog-post>
 ```
 
-とりあえず DOM テンプレートパース時の警告についてはこれで以上です。そして実は、Vue の _本質_ の最後となります。おめでとうございます！まだまだ学ぶべきことはありますが、まずは一休みして自分で Vue を実際に使って楽しいものを作ってみることをお勧めします。
+とりあえず DOM テンプレートパース時の警告についてはこれで以上です。そして実は、Vue の _本質_ の最後となります。おめでとうございます！まだまだ学ぶべきことはありますが、まずは一休みして自分で Vue を実際に使って楽しいものを作ってみることをおすすめします。
 
-理解したばかりの知識に慣れてきたら、サイドバーのコンポーネントの詳細セクションの他のページと同様に、[動的 & 非同期コンポーネント](component-dynamic-async.html)の完全なガイドを読むために戻ってくることをお勧めします。
+理解したばかりの知識に慣れてきたら、サイドバーのコンポーネントの詳細セクションの他のページと同様に、[動的 & 非同期コンポーネント](component-dynamic-async.html)の完全なガイドを読むために戻ってくることをおすすめします。

src/guide/component-custom-events.md

@@ -14,7 +14,7 @@ this.$emit('myEvent')
 <my-component @my-event="doSomething"></my-component>
 ```
 
-[プロパティの形式](/guide/component-props.html#プロパティの形式-キャメルケース-vs-ケバブケース) と同じように、DOM 内テンプレートを使っている場合は、ケバブケースのイベントリスナを使うことをお勧めします。文字列テンプレートを使っている場合は、この制約は適用されません。
+[プロパティの形式](/guide/component-props.html#プロパティの形式-キャメルケース-vs-ケバブケース) と同じように、DOM 内テンプレートを使っている場合は、ケバブケースのイベントリスナを使うことをおすすめします。文字列テンプレートを使っている場合は、この制約は適用されません。
 
 ## カスタムイベントの定義
 
@@ -31,7 +31,7 @@ app.component('custom-form', {
 ネイティブイベント（例、 `click` など）が `emits` オプションで定義されている場合、ネイティブイベントリスナの **代わりに** コンポーネントのイベントが使われます。
 
 ::: tip
-コンポーネントの動作を実証するために、全ての発行されたイベントを定義することをお勧めします。
+コンポーネントの動作を実証するために、全ての発行されたイベントを定義することをおすすめします。
 :::
 
 ### 発行されたイベントを検証する

src/guide/component-registration.md

@@ -159,7 +159,7 @@ ES2015 以降の場合、`ComponentA` のような変数名をオブジェクト
 
 ### モジュールシステム内のローカル登録
 
-もしまだこの記事を読んでいるということは、Webpack や Babel のようなモジュールシステムを利用している可能性が高いでしょう。このような場合は、それぞれのコンポーネントを独自のファイルに持つ `components` ディレクトリを作成することをお勧めします。
+もしまだこの記事を読んでいるということは、Webpack や Babel のようなモジュールシステムを利用している可能性が高いでしょう。このような場合は、それぞれのコンポーネントを独自のファイルに持つ `components` ディレクトリを作成することをおすすめします。
 
 次にローカル登録をする前に、使用するコンポーネントごとにインポートする必要があります。例えば、`ComponentB.js` もしくは `ComponentB.vue` ファイルの場合:
 

src/guide/contributing/doc-style-guide.md

@@ -27,7 +27,7 @@ VuePress は、アラートボックスを作成するためのカスタムコ
 :::
 
 ::: danger DANGER
-これはお勧めしません。自己責任で使用してください。
+これはおすすめしません。自己責任で使用してください。
 :::
 ```
 
@@ -46,7 +46,7 @@ VuePress は、アラートボックスを作成するためのカスタムコ
 :::
 
 ::: danger DANGER
-これはお勧めしません。自己責任で使用してください。
+これはおすすめしません。自己責任で使用してください。
 :::
 
 ## コードブロック