Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: move think-qwik page to concepts route #4499

Merged
merged 3 commits into from
Jun 19, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ yarn create qwik@latest
```

- Understand the difference between [resumable and replayable](https://qwik.builder.io/docs/concepts/resumable/) applications.
- Learn about Qwik's high level [mental model](https://qwik.builder.io/docs/think-qwik/).
- Learn about Qwik's high level [mental model](https://qwik.builder.io/docs/concepts/think-qwik/).

## Resources

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ contributors:

Progressive is about downloading code according to the application's needs, without eagerly downloading the entire code base.

This connects us to the [core principle](../../think-qwik/index.mdx) of Qwik which focuses on delaying **the loading** and execution of JavaScript for as long as possible. Qwik needs to break up the application into many lazy loadable chunks to achieve that.
This connects us to the [core principle](../../concepts/think-qwik/index.mdx) of Qwik which focuses on delaying **the loading** and execution of JavaScript for as long as possible. Qwik needs to break up the application into many lazy loadable chunks to achieve that.

## Current state-of-the-art

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Qwik is fast not because it uses clever algorithms but because it is designed in

## Resumability & Serialization

Resumability is discussed in detail [here](../concepts/resumable/index.mdx). Resumability allows Qwik applications to continue execution where the server left off. All frameworks need to keep track of internal data structures about the application's state. The current generation of frameworks does not preserve this information when transitioning from the server to the browser. As a result, the framework's data structures need to be rebuilt in the browser, duplicating the work that was done on the server. The rebuilding of data structures and attaching of listeners is called hydration.
Resumability is discussed in detail [here](../resumable/index.mdx). Resumability allows Qwik applications to continue execution where the server left off. All frameworks need to keep track of internal data structures about the application's state. The current generation of frameworks does not preserve this information when transitioning from the server to the browser. As a result, the framework's data structures need to be rebuilt in the browser, duplicating the work that was done on the server. The rebuilding of data structures and attaching of listeners is called hydration.

Qwik serializes listeners, internal data structures, and application state into the HTML during the server-browser handoff. Because all of the information is serialized in HTML, the client can just resume execution where the server left off.

Expand Down
2 changes: 1 addition & 1 deletion packages/docs/src/routes/docs/(qwik)/faq/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ The short answer is that Qwik solves a problem that other frameworks can't solve

We designed Qwik to be [extremely easy to learn](/docs/(qwikcity)/guides/react-cheat-sheet/index.mdx) and become productive in for React developers. Developing components is pretty much the same as React, and routing is inspired by Nextjs and others.

However, there are fundamentally [new concepts](../think-qwik/index.mdx) to learn, such as [Resumability](../concepts/resumable/index.mdx) and fine-grained reactivity, but we think the learning curve is not steep.
However, there are fundamentally [new concepts](../concepts/think-qwik/index.mdx) to learn, such as [Resumability](../concepts/resumable/index.mdx) and fine-grained reactivity, but we think the learning curve is not steep.

We also have an interactive [tutorial](../../tutorial/welcome/overview/) to get you started.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ To get started with Qwik locally, you need the following:

- [Node.js v16.8](https://nodejs.org/en/download/) or higher
- Your favorite IDE ([vscode](https://code.visualstudio.com/) recommended)
- Optionally, read [think qwik](../think-qwik/index.mdx)
- Optionally, read [think qwik](../concepts/think-qwik/index.mdx)

## Create an app using the CLI

Expand Down
2 changes: 1 addition & 1 deletion packages/docs/src/routes/docs/(qwik)/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Qwik is a new kind of web framework that can deliver instant loading web applica
<img class="intro-icon" src="/icons/getting_started_rocket.svg" width={45} style="margin-bottom:-7px"/>
<h3>Getting Started</h3>
</a>
<a class="card card-center" href="/docs/think-qwik/">
<a class="card card-center" href="/docs/concepts/think-qwik/">
<img class="intro-icon" src="/icons/why_qwik_logo.svg" width={70}/>
<h3>Why Qwik?</h3>
</a>
Expand Down
2 changes: 1 addition & 1 deletion packages/docs/src/routes/docs/menu.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@

## Concepts

- [Think Qwik](/docs/(qwik)/think-qwik/index.mdx)
- [Think Qwik](/docs/(qwik)/concepts/think-qwik/index.mdx)
- [Resumable](/docs/(qwik)/concepts/resumable/index.mdx)
- [Progressive](/docs/(qwik)/concepts/progressive/index.mdx)
- [Reactivity](/docs/(qwik)/concepts/reactivity/index.mdx)
Expand Down