Skip to content

Commit

Permalink
tweak: 🔧 remove unnecessary explain (#284)
Browse files Browse the repository at this point in the history
  • Loading branch information
Ubugeeei committed May 19, 2024
1 parent 550a257 commit 1a9c889
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 20 deletions.
16 changes: 5 additions & 11 deletions book/online-book/src/10-minimum-example/100-break.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,10 @@

## Minimal Example 部門はここまで!

冒頭で、この本はいくつかの部門に分かれるという話をしたのですが、それの一番最初の部門である「Minimal Example 部門」はここまでで終了です。お疲れ様でした。
なぜ、わざわざ「部門」という呼び方にしているかというと、理由は2つあります。
まず一つは、ここからはそれぞれの部門でなるべく依存関係を持たないような構成にすることで、それぞれが興味のある範囲(部門)での理解を深めることができるということを目指しているからです。
Virtual DOM やパッチレンダリング周りに興味がある人は Basic Virtual DOM 部門に進めばいいですし、コンポーネントをもっと拡張したければ Basic Component 部門、
テンプレートでもっと豊かな表現(ディレクティブなど)に興味があれば Basic Template Compiler 部門、script setup やコンパイラマクロに興味があれば Basic SFC Compiler 部門に進めば良いです。(勿論全部やってもいいですよ!!)
そして何よりこのこの「Minimal Example 部門」もひとつの立派な部門なわけですから、「そんなに深くは知らなくてもいいけど、全体的にサラッとやりたい!」という方はここまでで十分なのです。
(Web Application Essentials 部門に関しては、ある程度 Vue の Basic な実装に依存にする部分があるので、各部門の実装が少し混ざってしまっています。)
冒頭で、この本はいくつかの部門に分かれるという話をしたのですが、それの一番最初の部門である「Minimal Example 部門」はここまでで終了です。お疲れ様でした 😁\
Virtual DOM やパッチレンダリング周りに興味がある人は Basic Virtual DOM 部門に進めばいいですし、コンポーネントをもっと拡張したければ Basic Component 部門、\
テンプレートでもっと豊かな表現(ディレクティブなど)に興味があれば Basic Template Compiler 部門、script setup やコンパイラマクロに興味があれば Basic SFC Compiler 部門に進めば良いです。(勿論全部やってもいいですよ!!)\
そして何よりこのこの「Minimal Example 部門」もひとつの立派な部門なわけですから、「そんなに深くは知らなくてもいいけど、全体的にサラッとやりたい!」という方はここまでで十分なのです。\

## ここまでで何ができるようになった?

Expand Down Expand Up @@ -308,7 +305,6 @@ export default {
## これからについて

これからは、より実用的なものにしていくにあたって、それぞれのパートをより詳しくやっていきます。
それに伴って、これ以降の各部門の最初のソースコードは「Minimal Example 部門の最後のソースコードの状態」からスタートします。
そして、これから各部門でやることと、進め方(方針)について少し説明します。

## どういうことをやるのか
Expand Down Expand Up @@ -339,8 +335,6 @@ export default {
- Web Application Essentials 部門 (付録)

この部門は付録です。Web 開発において、頻繁に Vue と共に利用されるライブラリの実装をします。
この部門だけは、ある程度他の部門に依存する部分があります。
勿論、この部門からやり始めて他の部門でやる必要な実装については随時やっていく、という方針でも問題はないですが、多少わかりづらい可能性はあります。

- store
- route
Expand All @@ -352,6 +346,6 @@ export default {
Minimal Example 部門ではかなり細かめに実装の手順について説明してきました。
ここまで実装してきた皆さんならば、もうかなり本家 Vue のソースコードを読めるようになっているはずです。
そこでこれ以降の部では、説明は大まかな方針までにとどめて、実際のコードは本家のコードを読みながら、もしくは自分で考えながら実装していこうと思います。
(け、決して、細かく書くのが面倒臭くなってきたとか、そういうことではないですからね! )
(け、決して、細かく書くのが面倒臭くなってきたとか、そういうことではないですからね!)
まあ、本を読んでその通りに実装するのは最初のうちは楽しいですが、ある程度形になってきたら自分でやってみるほうが楽しいですし、より深い理解にもつながるかと思います。
ここから先はこの本はある種のガイドライン程度に捉えて貰って、本編は Vue 本家にあります!
19 changes: 10 additions & 9 deletions book/online-book/src/en/10-minimum-example/100-break.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,9 @@

## Minimal Example section is over!

At the beginning, I mentioned that this book is divided into several sections, and the first section, "Minimal Example," is now complete. Well done!
The reason why I specifically use the term "section" is because there are two reasons.
First, from here on, I aim to create a configuration where each section has as little dependency as possible, so that each section can deepen their understanding in their respective areas of interest (sections).
If you are interested in Virtual DOM and patch rendering, you can proceed to the Basic Virtual DOM section. If you want to extend components further, you can go to the Basic Component section. If you are interested in richer expressions (directives, etc.) with templates, you can go to the Basic Template Compiler section. If you are interested in script setup and compiler macros, you can proceed to the Basic SFC Compiler section. (Of course, you can do all of them if you want!)
And above all, since this "Minimal Example" is also a respectable section, if you just want to have a general understanding without going too deep, it is sufficient to stop here.
(Regarding the Web Application Essentials section, there are some dependencies on the basic implementation of Vue, so the implementations of each section are mixed to some extent.)
At the beginning, I mentioned that this book is divided into several sections, and the first section, "Minimal Example Section," is now complete. Well done 😁\
If you are interested in Virtual DOM or patch rendering, you can move on to the Basic Virtual DOM section. If you want to extend components further, there is the Basic Component section. If you are interested in richer expressions in templates (such as directives), you can explore the Basic Template Compiler section. If you are interested in script setup or compiler macros, you can proceed to the Basic SFC Compiler section. (Of course, you can do them all if you want!!)\
Above all, the "Minimal Example Section" is also a respectable section, so if you feel like, "I don't need to know too deeply, but I want to get a general idea," then you are good to go up to this point.

## What have we achieved so far?

Expand Down Expand Up @@ -305,7 +302,7 @@ export default {
## About the Future

From now on, in order to make it more practical, we will go into more detail in each part.
With that, the initial source code for each part after this will start from the state of the "Minimal Example" part. I will explain a little about what to do and how to proceed (policy) for each part.
I will explain a little about what to do and how to proceed (policy) for each part.

### What to do

Expand Down Expand Up @@ -333,7 +330,7 @@ From here, it will be divided into 5 parts + 1 appendix.
- compiler macro
- Web Application Essentials Part (Appendix)

This part is an appendix. In this part, we will implement libraries that are frequently used together with Vue in web development. This part has some dependencies on other parts. Of course, it is also possible to start from this part and implement the necessary parts in other parts as you go along, but it may be a little confusing.
This part is an appendix. In this part, we will implement libraries that are frequently used together with Vue in web development.

- store
- route
Expand All @@ -342,4 +339,8 @@ We will cover the above two, but feel free to implement other things that come t

### Policy

In the Minimal Example part, we explained the implementation steps in quite detail. By now, if you have implemented it, you should be able to read the source code of the original Vue. Therefore, from now on, the explanations will be kept to a rough policy, and you will implement the actual code while reading the original code or thinking on your own. (N-no, it's not that I'm getting lazy to write in detail or anything like that!) Well, it's fun to implement it as the book says, but once it starts to take shape, it's more fun to do it yourself and it leads to a deeper understanding. From here on, please consider this book as a kind of guideline, and the main content is in the original Vue source code!
In the Minimal Example part, we explained the implementation steps in quite detail. By now, if you have implemented it, you should be able to read the source code of the original Vue.
Therefore, from now on, the explanations will be kept to a rough policy, and you will implement the actual code while reading the original code or thinking on your own.
(N-no, it's not that I'm getting lazy to write in detail or anything like that!)
Well, it's fun to implement it as the book says, but once it starts to take shape, it's more fun to do it yourself and it leads to a deeper understanding.
From here on, please consider this book as a kind of guideline, and the main content is in the original Vue source code!

0 comments on commit 1a9c889

Please sign in to comment.