request: migrate from Nuxt@v3 to Nuxt@v4

shinGangan commented 5 months ago

概要

Nuxt4へのマイグレーション記事を書いてほしい

詳細

先日Nuxt v3.12がリリースされた。

https://nuxt.com/blog/v3-12

v3.12の紹介の中でNuxt4へのマイグレーションが紹介されていた。本件についての記事を書いて欲しい

備考欄

No response

kspace-trk commented 5 months ago

ノ

kspace-trk commented 5 months ago

Nuxt4リリース前に公開しなきゃなので、とりあえず形にしました！以下の3つが伝わればいいな〜という感じで簡易的な記事にしました！

Nuxt4を事前に試すことができる
そんなに難しくない
すでに公式ガイドが存在する

https://zenn.dev/comm_vue_nuxt/articles/2b3ed4ed07723a

詳細な移行ステップなどに関しては、Nuxt4正式リリースしてからでいいかな〜と思ってますざっとお目通しいただいて、よさそうでしたら公開しちゃいます！

shinGangan commented 5 months ago

@kspace-trk

レビューします！⭕️

kspace-trk commented 5 months ago

ありがとうございます！全体的に内容薄いかもな、、？と思いつつ、触れ始めたらキリがないのでどうするか、、と悩んでいました

shinGangan commented 5 months ago

@kspace-trk

レビューしました！

レビューコメント

[!NOTE]

Qから始まるやつは疑問です。不要だったらスルーしてください。

Sから始まるやつは提案です。採用については一任です。

prefix無しのものはレビュー指摘です

タイトル

メジャーバージョンのマイグレーションは本来大変なことであり、非常に腰が重いタスクです。 Vue2 → Vue3、Nuxt2 → Nuxt Bridge → Nuxt3を経てきたコミュニティはその大変さを身に染みて分かってるはずです。そんな人達が「え、こんな簡単でええの？」と驚き、引き付けるようなタイトルの方が良いかと思いました。

故意に他界隈も含めて煽るのではなく、Nuxt利用者で感動を分かち合うために少し煽り目のタイトルでもいいと思います(所感)。

はじめに

S: 「はじめに」の項ではNuxt4へのマイグレーションが出来ること、Nuxt v3.12以降すでに利用可能であることに留め、オプションの話は「まとめ」の項を次節に作る感じでいかがでしょうか。

導入とオプション詳細は分けた方がユーザーライクです。

変更点について

S: もう少し触れてみるのはいかがでしょうか。現行だとNuxt4移行後のpros/consがあまり分からないなと思いました！
S: ディレクトリの変更について、Nuxt3との比較を掲載するのはいかがでしゃうか。普段からNuxtを使ってる人は現行文で伝わりますが、これからNuxt3にチャレンジする方は分からないと思いました。

そのため、もし私だったらNuxt3とNuxt4のディレクトリツリーをそれぞれ掲載します。公式のスターターはapp.vueベースなので、pages/ベースのツリーだと現場寄りかなと思います。

S. Nuxt4モードでNuxt3ディレクトリ構造は正常に動作する？

ディレクトリ構造の変更はプロダクト側の大きな負担となります。大体の現場が工数見積りを検討してマイグレーションすることでしょう。

そのため、「Nuxt3のディレクトリ構造でNuxt4オプションは有効にしても良いのか？」は疑問に思うことでしょう (たしか公式repoに質問イシューあったような)。

この不安を解消することは本記事を読んだ人にとって重要な事項であり、本件の疑問解消こそ本記事の責務にしてもいいと思います(所感)

全体通して

マイグレーションはつらく大変なものです。それがこんなに簡単に済むことの感動を読者に提供出きるといいですね

備考

S. Nuxt starter、Nuxt UI Proテンプレート、NuxtHubテンプレートなど主要なテンプレートは軒並みマイグレーション済みです。こちらをappendix として掲載することでユーザーの参考資料が増えます。

掲載いかがでしょうか。

kspace-trk commented 5 months ago

@shinGangan コメントありがとうございます！いただいたコメントをもとに、いくつか更新をかけようと思います！

タイトル

これまでは Nuxt3でNuxt4を試してみる (Opting in to Nuxt 4)でしたが、移行が簡単であることが伝わるキャッチーなタイトルにしてみます！

はじめに

冒頭の部分で突然optionに関する話をしてしまっていたので、別の項や節に切り出します！

変更点について

たしかに、内容に触れずに「この記事を見てね」だけになっていたので、もう少し内容に触れます！

ディレクトリ構成の変更も、わかりやすく画像を用いて差分がわかるようにします！

S. Nuxt4モードでNuxt3ディレクトリ構造は正常に動作する？

S. Nuxt4モードでNuxt3ディレクトリ構造は正常に動作する？

については、この記事で伝えたいことの一つなので、もう少し詳細に書きます！

kspace-trk commented 4 months ago

@shinGangan めちゃくちゃいい感じになりました！！いかがでしょうか！！ https://zenn.dev/comm_vue_nuxt/articles/2b3ed4ed07723a

Nuxt4への移行は大変じゃなさそう！ (Opting in to Nuxt 4)

タイトル案ほかにあればご教示いただけると嬉しいです 🙆‍♂️

kspace-trk commented 4 months ago

よさそうな気配しているので明日だします！ (レビュー中だったらすみません)

shinGangan commented 4 months ago

よさそうな気配しているので明日だします！ (レビュー中だったらすみません)

@kspace-trk

特に問題ないかと思います～🙆‍♀️ LGTM！🔥

kspace-trk commented 4 months ago

(いくつか言い回しを修正してから公開する)

kspace-trk commented 4 months ago

Published! https://zenn.dev/comm_vue_nuxt/articles/2b3ed4ed07723a

shinGangan commented 4 months ago

公開を確認したので本イシューをクローズします。

chibivue-land / articles-zenn-plaza