Skip to content

Commit f53bcb1

Browse files
committed
improve intro for absolute beginners (close vuejs#565)
1 parent 257c80b commit f53bcb1

File tree

2 files changed

+14
-2
lines changed

2 files changed

+14
-2
lines changed

src/guide/index.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,15 @@ If you are an experienced frontend developer and want to know how Vue compares t
1212

1313
## Getting Started
1414

15-
The easiest way to try out Vue.js is using the [JSFiddle Hello World example](https://jsfiddle.net/chrisvfritz/50wL7mdz/). Feel free to open it in another tab and follow along as we go through some basic examples. If you prefer downloading / installing from a package manager, check out the [Installation](/guide/installation.html) page.
15+
<p class="tip">The official guide assumes intermediate level front-end knowledge of HTML, CSS and JavaScript. If you are totally new to front-end development, it might not be the best idea to jump right into a framework as your first step - grasp the basics then come back! Prior experience with other frameworks helps, but is not required.</p>
16+
17+
The easiest way to try out Vue.js is using the [JSFiddle Hello World example](https://jsfiddle.net/chrisvfritz/50wL7mdz/). Feel free to open it in another tab and follow along as we go through some basic examples. Or, you can simply create an `.html` file and include Vue with:
18+
19+
``` html
20+
<script src="https://unpkg.com/vue/dist/vue.js">
21+
```
22+
23+
The [Installation](/guide/installation.html) page provides more options of installing Vue. Note that we **do not** recommend beginners to start with `vue-cli`, especially if you are not yet familiar with Node.js-based build tools.
1624
1725
## Declarative Rendering
1826

src/guide/installation.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,9 @@ $ npm install vue
4646

4747
### Standalone vs. Runtime-only Build
4848

49-
There are two builds available, the standalone build and the runtime-only build.
49+
There are two builds available, the standalone build and the runtime-only build. The difference being that the former includes the **template compiler** and the latter does not.
50+
51+
The template compiler is responsible for compiling Vue template strings into pure JavaScript render functions. If you want to use the `template` option, then you need the compiler.
5052

5153
- The standalone build includes the compiler and supports the `template` option. **It also relies on the presence of browser APIs so you cannot use it for server-side rendering.**
5254

@@ -87,6 +89,8 @@ $ npm install
8789
$ npm run dev
8890
```
8991

92+
<p class="tip">The CLI assumes prior knowledge of Node.js and the associated build tools. If you are new to Vue or front-end build tools, we strongly suggest going through the <a href="/guide">guide</a> without any build tools before using the CLI.</p>
93+
9094
## Dev Build
9195

9296
**Important**: the built files in GitHub's `/dist` folder are only checked-in during releases. To use Vue from the latest source code on GitHub, you will have to build it yourself!

0 commit comments

Comments
 (0)