|
4 | 4 |
|
5 | 5 | クックブックはガイドとどう違うのでしょうか?なぜそれが必要なのでしょうか?
|
6 | 6 |
|
7 |
| -- **よりフォーカスする**: ガイドの中では、基本的にストーリーを語っています。それぞれのセクションは、前のセクションの知識を基にしています。クックブックにおいては、それぞれのレシピはそれ自体が独立しています。つまりレシピは、一般的なVueの概要を説明するのではなく、Vueの特定の側面に焦点を当てることができます。 |
| 7 | +- **よりフォーカスする**: ガイドの中では、基本的にストーリーを語っています。それぞれのセクションは、前のセクションの知識を基にしています。クックブックにおいては、それぞれのレシピはそれ自体が独立しています。つまりレシピは、一般的な Vue の概要を説明するのではなく、Vue の特定の側面に焦点を当てることができます。 |
8 | 8 |
|
9 | 9 | - **より深くまで**: ガイドは長くなりすぎず、それぞれの機能を理解していただくために、可能な限り簡単な例だけを掲載するようにしています。そして次に進みます。クックブックでは、興味深い方法で機能を組み合わせた、より複雑な例を含めることができます。それぞれレシピはまた、それらの例を完全に探求するために、必要なだけ長くて詳細なものにすることができます。
|
10 | 10 |
|
11 |
| -- **JavaScriptを教える**: ガイドでは、少なくともES5のJavaScriptの中級程度の知識があることを前提としています。例えば、 `Array.prototype.filter` がリストをフィルタリングする計算プロパティでどのように動作するかは説明しません。しかし、クックブックでは、必須の JavaScript 機能 (ES6/2015+ を含む) を探索し、より良い Vue アプリケーションの構築にどのように役立つのかという文脈で説明します。 |
| 11 | +- **JavaScript を教える**: ガイドでは、少なくとも ES5 の JavaScript の中級程度の知識があることを前提としています。例えば、 `Array.prototype.filter` がリストをフィルタリングする計算プロパティでどのように動作するかは説明しません。しかし、クックブックでは、必須の JavaScript 機能 (ES6/2015+ を含む) を探索し、より良い Vue アプリケーションの構築にどのように役立つのかという文脈で説明します。 |
12 | 12 |
|
13 |
| -- **エコシステムを探求する**: 高度な機能については、ある程度のエコシステムの知識を前提としています。たとえば、Webpack でシングルファイルコンポーネントを使用したい場合、Webpack の confing についての Vue 以外の部分を設定する方法については説明しません。クックブックでは、少なくともVue開発者にとって普遍的に有用な範囲でこれらのエコシステムライブラリをより深く探求するスペースがあります。 |
| 13 | +- **エコシステムを探求する**: 高度な機能については、ある程度のエコシステムの知識を前提としています。たとえば、Webpack でシングルファイルコンポーネントを使用したい場合、Webpack の confing についての Vue 以外の部分を設定する方法については説明しません。クックブックでは、少なくとも Vue 開発者にとって普遍的に有用な範囲でこれらのエコシステムライブラリをより深く探求するスペースがあります。 |
14 | 14 |
|
15 | 15 | ::: ヒント
|
16 |
| -これらの違いはあるものの、クックブックはまだステップバイステップのマニュアルではないことに注意してください。その内容のほとんどは、HTML、CSS、JavaScript、npm/yarnなどの概念を基本的に理解していることが求められます。 |
| 16 | +これらの違いはあるものの、クックブックはまだステップバイステップのマニュアルではないことに注意してください。その内容のほとんどは、HTML、CSS、JavaScript、npm/yarn などの概念を基本的に理解していることが求められます。 |
17 | 17 |
|
18 | 18 | ## クックブックへの貢献
|
19 | 19 |
|
20 | 20 | ### 私たちが求めているもの
|
21 | 21 |
|
22 | 22 | このクックブックでは、一般的なユースケースや興味深いユースケースを網羅した開発者向けのサンプルを提供したり、より複雑な細かい部分を段階的にに説明していきます。私たちの目標は、単純な入門的な例を超えて、より広く適用可能な概念を示すことと、アプローチの注意点を示すことです。
|
23 | 23 |
|
24 |
| -貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いてissueを提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くお勧めしますが、必須ではありません。 |
| 24 | +貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いて issue を提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くお勧めしますが、必須ではありません。 |
25 | 25 |
|
26 | 26 | レシピは一般的に:
|
27 | 27 |
|
|
55 | 55 | 一般的なユースケースや興味深いユースケースを動かすコードを、以下のいずれかの方法で実行してください。
|
56 | 56 |
|
57 | 57 | 1. セットアップの簡潔な例をいくつか紹介する。または
|
58 |
| -2. codepen / jsfiddleの埋め込みの例 |
| 58 | +2. codepen / jsfiddle の埋め込みの例 |
59 | 59 |
|
60 | 60 | 後者を選択した場合でも、それが何であり、何をするのかをディスカッションする必要があります。
|
61 | 61 |
|
|
65 | 65 |
|
66 | 66 | ### このパターンを回避するケース <Badge text="任意" />
|
67 | 67 |
|
68 |
| -このセクションは必須ではありませんが、書くことを強くお勧めします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixinsのようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"]](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。 |
| 68 | +このセクションは必須ではありませんが、書くことを強くお勧めします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixins のようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"]](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。 |
69 | 69 |
|
70 | 70 | ### 代替パターン <Badge text="必須 with avoidance section" type="warning" />
|
71 | 71 |
|
|
0 commit comments