Zengtudor/Nuxt
1
0
Fork 0
mirror of https://github.com/nuxt/nuxt.git synced 2024-11-22 13:45:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(migration): restructure upgrade guide (#7730)

Browse Source
This commit is contained in:
Clément Ollivier 2022-09-22 17:24:32 +02:00 committed by GitHub
parent 2894a75bc8
commit 71ef8bd3ff
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 62 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/content/1.getting-started/10.upgrade-guide/0.migration.md
View File

@ -1,28 +0,0 @@
# Migration Guide
Already have a Nuxt project to migrate? These migration guides are for users wanting to upgrade their Nuxt application to Nuxt 3 or take the first step in that direction with Nuxt Bridge.
- [**From Nuxt 2 to Nuxt 3**](/migration/overview)
- [From Nuxt 2 to Nuxt Bridge](/bridge/overview)
## Feature Comparison
In the table below, there is a quick comparison between 3 versions of Nuxt:
Feature / Version | Nuxt 2 | Nuxt Bridge | Nuxt 3
-------------------------|-----------------|------------------|---------
Vue | 2 | 2 | 3
Stability | 😊 Stable | 😌 Semi-stable | 😬 Unstable
Performance | 🏎 Fast | ✈️ Faster | 🚀 Fastest
Nitro Engine | ❌ | ✅ | ✅
ESM support | 🌙 Partial | 👍 Better | ✅
TypeScript | ☑️ Opt-in | 🚧 Partial | ✅
Composition API | ❌ | 🚧 Partial | ✅
Options API | ✅ | ✅ | ✅
Components Auto Import | ✅ | ✅ | ✅
`<script setup>` syntax | ❌ | 🚧 Partial | ✅
Auto Imports | ❌ | ✅ | ✅
Webpack | 4 | 4 | 5
Vite | ⚠️ Partial | 🚧 Partial | ✅
Nuxi CLI | ❌ Old | ✅ nuxi | ✅ nuxi
Static sites | ✅ | ✅ | 🚧 Experimental

59
docs/content/1.getting-started/10.upgrade.md Normal file
View File

@ -0,0 +1,59 @@
# Upgrade Guide
Have a Nuxt 2 project to migrate? Use these guides to upgrade your Nuxt applications to Nuxt 3 or take the first step in that direction with Nuxt Bridge.
If you are already using Nuxt 3 and want to upgrade to the latest release or test new features before their release, head over to the [Upgrading Nuxt 3](#upgrading-nuxt-3) section.
## Feature Comparison
In the table below, there is a quick comparison between 3 versions of Nuxt:
Feature / Version | Nuxt 2 | Nuxt Bridge | Nuxt 3
-------------------------|-----------------|------------------|---------
Vue | 2 | 2 | 3
Stability | 😊 Stable | 😌 Semi-stable | Release candidate
Performance | 🏎 Fast | ✈️ Faster | 🚀 Fastest
Nitro Engine | ❌ | ✅ | ✅
ESM support | 🌙 Partial | 👍 Better | ✅
TypeScript | ☑️ Opt-in | 🚧 Partial | ✅
Composition API | ❌ | 🚧 Partial | ✅
Options API | ✅ | ✅ | ✅
Components Auto Import | ✅ | ✅ | ✅
`<script setup>` syntax | ❌ | 🚧 Partial | ✅
Auto Imports | ❌ | ✅ | ✅
Webpack | 4 | 4 | 5
Vite | ⚠️ Partial | 🚧 Partial | ✅
Nuxi CLI | ❌ Old | ✅ nuxi | ✅ nuxi
Static sites | ✅ | ✅ | ✅
## Nuxt 2 to Nuxt 3
The migration guide provides a step-by-step comparison of Nuxt 2 features to Nuxt 3 features and guidance to adapt your current application.
::alert{type=info icon=👉}
[**Migrate from From Nuxt 2 to Nuxt 3**](/migration/overview)
::
## Nuxt 2 to Nuxt Bridge
If you prefer to progressively migrate your Nuxt 2 application to Nuxt 3, you can use Nuxt Bridge. Nuxt Bridge is a compatibility layer that allows you to use Nuxt 3 features in Nuxt 2 with an opt-in mechanism.
::alert{type=info icon=👉}
[**Migrate from Nuxt 2 to Nuxt Bridge**](/bridge/overview)
::
## Upgrading Nuxt 3
### Latest release
To upgrade Nuxt 3 to the latest release, use the `nuxi upgrade` command.
```bash
npx nuxi upgrade
```
### Edge release channel
::alert{type=info icon=👉}
To use the latest Nuxt 3 build and test features before their release, read the [edge release channel](/guide/going-further/edge-channel) guide.
::

0
docs/content/1.getting-started/10.upgrade-guide/1.edge-channel.md → docs/content/2.guide/4.going-further/11.edge-channel.md
View File

5
docs/static/_redirects vendored
View File

@ -40,8 +40,9 @@
/guide/features/state-management /getting-started/state-management 302!
/guide/features/error-handling /getting-started/error-handling 302!
/guide/going-further/testing /getting-started/testing 302!
/getting-started/migration /getting-started/upgrade-guide/migration 302!
/guide/going-further/edge-channel /getting-started/upgrade-guide/edge-channel 302!
/getting-started/migration /getting-started/upgrade-guide/migration 302
/getting-started/upgrade-guide/migration /getting-started/upgrade 302!
/getting-started/upgrade-guide/edge-channel /guide/going-further/edge-channel 302!
/guide/features/modules /guide/concepts/modules 302!
/guide/features/server-routes /guide/directory-structure/server 302!
/guide/going-further/esm /guide/concepts/esm 302!