Skip to content

Commit 8872edc

Browse files
committed
add prerequisite after intro
1 parent a7e5f3e commit 8872edc

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

src/guide/introduction.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ footer: false
55
# Introduction
66

77
:::info You are reading the documentation for Vue 3!
8+
89
- Vue 2 documentation has been moved to [v2.vuejs.org](https://v2.vuejs.org/).
910
- Upgrading from Vue 2? Check out the [Migration Guide](https://v3-migration.vuejs.org/).
1011
:::
@@ -50,24 +51,28 @@ const count = ref(0)
5051

5152
The above example demonstrates the two core features of Vue:
5253

53-
- **Declarative Rendering**: Vue extends standard HTML with templating syntax that allows us to declaratively describe HTML output based on JavaScript state.
54+
- **Declarative Rendering**: Vue extends standard HTML with a template syntax that allows us to declaratively describe HTML output based on JavaScript state.
5455

5556
- **Reactivity**: Vue automatically tracks JavaScript state changes and efficiently updates the DOM when changes happen.
5657

5758
You may already have questions - don't worry. We will cover every little detail in the rest of the documentation. For now, please read along so you can have a high-level understanding of what Vue offers.
5859

60+
:::tip Prerequisites
61+
The rest of the documentation assumes basic familiarity with HTML, CSS and JavaScript. If you are totally new to front 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.
62+
:::
63+
5964
## The Progressive Framework
6065

6166
Vue is a framework and ecosystem that covers most of the common features needed in frontend development. But the web is extremely diverse - the things we build on the web may vary drastically in form and scale. With that in mind, Vue is designed to be flexible and incrementally adoptable. Depending on your use case, Vue can be used in different ways:
6267

63-
- Enhancing backend-rendered HTML without a build step
68+
- Enhancing static HTML without a build step
6469
- Embedding as Web Components on any page
6570
- Single-Page Application (SPA)
6671
- Fullstack / Server-Side-Rendering (SSR)
6772
- JAMStack / Static-Site-Generation (SSG)
6873
- Targeting desktop, mobile, WebGL or even the terminal
6974

70-
If you are a beginner and find these concepts intimidating, don't worry! The guide and tutorial only require basic HTML and JavaScript knowledge, and you should be able to follow along without being an expert in any of these.
75+
If you find these concepts intimidating, don't worry! The tutorial and guide only require basic HTML and JavaScript knowledge, and you should be able to follow along without being an expert in any of these.
7176

7277
If you are an experienced developer interested in how to best integrate Vue into your stack, or you are curious about what these terms mean, we discuss them in more details in [Ways of Using Vue](/guide/extras/ways-of-using-vue).
7378

@@ -206,14 +211,14 @@ Check out our [FAQ](/about/faq).
206211
Different developers have different learning styles. Feel free to pick a learning path that suits your preference - although we do recommend going over all content if possible!
207212

208213
<div class="vt-box-container next-steps">
209-
<a class="vt-box" href="/guide/quick-start.html">
210-
<p class="next-steps-link">Read the Guide</p>
211-
<p class="next-steps-caption">The guide walks you through every aspect of the framework in full details.</p>
212-
</a>
213214
<a class="vt-box" href="/tutorial/">
214215
<p class="next-steps-link">Try the Tutorial</p>
215216
<p class="next-steps-caption">For those who prefer learning things hands-on.</p>
216217
</a>
218+
<a class="vt-box" href="/guide/quick-start.html">
219+
<p class="next-steps-link">Read the Guide</p>
220+
<p class="next-steps-caption">The guide walks you through every aspect of the framework in full details.</p>
221+
</a>
217222
<a class="vt-box" href="/examples/">
218223
<p class="next-steps-link">Check out the Examples</p>
219224
<p class="next-steps-caption">Explore examples of core features and common UI tasks.</p>

0 commit comments

Comments
 (0)