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] Group migration and edge channel docs #14992

Closed
clemcode opened this issue Sep 21, 2022 — with Volta.net · 2 comments · Fixed by nuxt/framework#7730
Closed

[Docs] Group migration and edge channel docs #14992

clemcode opened this issue Sep 21, 2022 — with Volta.net · 2 comments · Fixed by nuxt/framework#7730

Comments

Copy link
Contributor

Currently, the migration guides summary and the edge channel page are grouped in two separate pages under the "Upgrade guide" section:

These pages could be merged onto a single "Upgrade guide" page with the following structure:

  • (Intro)
  • Comparison table
  • From Nuxt 2 to Nuxt 3
  • From Nuxt 2 to Bridge
  • Edge Release Channel

This would lead to a more flat structure and group all upgrade informations in the same place to make them more discoverable.

@danielroe
Copy link
Member

This sounds good to me 👍

@pi0
Copy link
Member

pi0 commented Sep 21, 2022

Agreed that having two categories in getting started is not nice.

For edge: We might move edge channel to the guide>advanced. (#14864) it is not suitable for starters really nor for normal users as we are moving toward 3.0.0 there should be fewer reasons to advocate edge.

If the upgrade guide were entirely inside the guide, we could append edge channel to the end of it but it is in getting started right now...

For Nuxt 2: migration from Nuxt 2 to Bridge/Nuxt3 shall be added to the end of getting started. Main audience of v3 docs as Nuxt 3 users we are writing upgrade guide for them.


Getting started > Upgrade Guide:

  • Upgrade Nuxt 3
  • Upgrade from Nuxt 2
    • Comparison table
    • Bridge
    • Nuxt 3
      Guide > Going Further
    • Edge Channel

@danielroe danielroe added the 3.x label Jan 19, 2023
@danielroe danielroe transferred this issue from nuxt/framework Jan 19, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants