Documentページの更新について

[Shinyaigeek]

提案とその経緯

https://nextjs.org/blog/new-documentation

2020/1/9~ Next.jsのDocsのデザインや内容が変わりました.

今の日本語翻訳されたdocs-jaは旧Docsに準じたデザイン, 内容になっています.
内容の更新に追いつくため, ユーザーの混乱を避けるためにNext.jsの新しいDocsに合わせて内容やデザインを変更したらどうでしょうか？

大掛かりな作業になると思われますので, 必要な作業をいかに分割しました

必要な作業

• docsを分割してsectionごとにmdで管理する(searchの機能の実装に必要かと)

• Designを本家の新デザインに合わせる

• search機能の実装

[5t111111]

@Shinyaigeek 確認が遅くなり申し訳ございません！

まず、ご提案ありがとうございます。
おっしゃる通り、本家のドキュメントがリニューアルされたことは把握しており、キャッチアップする必要性を感じておりましたが、そもそもドキュメントの Markdown ファイルだけでなくサイトページの構造にも手を加えてしまっているため、移行が大掛かりな作業になるので手をつけられておりませんでした。

必要な作業としてブレイクダウンしてくださった内容も妥当だと思います。

ただ、私の方で作業する時間が取れないため、一旦は翻訳ページ上で原文を参照するよう促す形でお茶を濁していた状態です…すみません。

Next.jsの日本での普及のためにできるだけ対応したいとは思っているのですが、今後もしばらくは更新ができないため、正直に申し上げて、このまま放置にならないためには、どなたかリードしてくだされる方のご協力が必要な状況です。

もし Shinyaigeek さんがリードしてくださるのであれば非常に助かりますので、勝手ながら今後の対応についていくつか提案させてください。

• もし本リポジトリを再利用できそうなら、以下のいずれかご希望の形を取りたいと思います
  • オーナーを移管させていただく
  • コミッターとして追加させていただく
  • 日本語化プロジェクトを organization として用意した上で移管する
• リポジトリを再利用できないようであれば、以下のいずれかのご希望の形を取りたいと思います
  • このリポジトリはアーカイブしてロックする
  • 新しいリポジトリを作成いただける際には、新リポジトリに誘導するリンクを本リポジトリに設定する
• Netlify で公開されているサイトについては、新しく作り直すのか現在のサイトを移管するのか別途検討する

いかがでしょうか。

[Shinyaigeek]

@5t111111
忙しい中ご丁寧に返信ありがとうございます 🙏

有志で, Next.jsの翻訳を手伝ってくださる方が何人か見つかったので, 5t111111 さんの提案してくださった中の, 日本語化プロジェクトを orgnazation として建てて, 移管した上で,

• (本家のものと同じように) 旧バージョンを pages/old以下に配置する形式で進める
• 新しいリポジトリを作成して, ある程度形になった時点で旧バージョンをアーカイブ, 新バージョンへの導線を表示する

かどちらかの形式で運用しようと思います！

Netlifyで公開されているサイトについては, 新しく作り直すか, 移管するかはまだ悩んでいます。。

その上でorgとリポジトリのMaintainerに 5t111111 さんを追加して余裕のあるときにでもお手伝いしてもらいたいなと思っているのですが如何でしょうか？もしよろしければGitHubのorg, repositoryとslackのinvitation送ります！

[5t111111]

ありがとうございます！
@Shinyaigeek さんや有志の方のお力添えで継続していけるのは非常に嬉しく思います。

方針についても承知しました。すぐに協力はできそうになく恐縮なのですが、ぜひぜひご招待くださればと思います。
GitHubのプロフにメアド晒していますので、invite で必要であればそちらをご利用ください！

[Shinyaigeek]

ありがとうございます！slackとGitHubのorganization, repositoryのinvitation送らせていただきました！
よろしくお願いします 🙏