ES2024に対応するIssueへのContributorを募集しています

[azu]

次のメジャーアップデート(v6)では、2024年6月末ごろにリリースされる予定のECMAScript 2024に対応する予定です。
そのため、ES2024の対応とユースケースであるNode.jsに関するアップデートをしていくマイルストーンを切りました。

• v6(ES2024) Milestone

ES2024に対応するマイルストーンをざっとみると、大体ざっくり換算12-20日分ぐらいのタスクがあります。

大きく分けて次の3つのグループに分かれています。

• ES2024の対応
• Stage 2.7の追加
• Node.jsのユースケースの更新

ES2024の対応

ES2024ではいくつか機能が増えているので、それに対応するアップデートを行います。
ECMAScript 2024の対応 · Issue #1706というIssueに、ES2024の対応についてのタスクをまとめています。

具体的に対応したいIssueは次の3つになっています。

• ES2024: array-grouping · Issue #1716
• ES2024: Well-Formed Unicode Strings · Issue #1715
• ES2022: Error Cause · Issue #1714

Array Groupingは恐らく対応が必須ですが、他の2つは可能なら対応する形になると思います。
これはjsprimerはリファレンスを作ることは、目的ではないことだからです。
なので、含めるべきか or 含めても不自然ではないかを調べるという感じのIssueです。
(あった方がいいかをちゃんと判断する)

Stgae 2.7の追加

ECMAScriptの仕様策定プロセス自体が変更されているので、それを解説するECMAScript · JavaScript Primer #jsprimerを更新する予定です。

• Stage 2.7を追加する · Issue #1713

多分これは自分がやる気はしていますが、やりたい方いたらコメントください。

Node.jsのユースケースの更新

Node.jsでCLIアプリ · JavaScript Primer #jsprimerの章を全体的にアップデートする予定です。

Meta: Node.jsのユースケースの更新 · Issue #1719というMeta Issueに依存関係をまとめています。
最近は、今まではnpmパッケージを使わないといけなかったものが、Node.jsの標準機能になったりしているので、それに対応する形のリファクタリングになります。

• Node.js 20 LTSへアップデートする · Issue #1718
• mochaを node:test に変更する · Issue #1717
• utils.parseArgsの利用法を追記 · Issue #1698
• markedjsのアップデート · Issue #1694

こちらは、サンプルコードのアップデートやそれにあわせた文章の変更が中心になります。
そのため、基本的に文章の意味合いを変えるような変更は少なくて、リファクタリング的な変更が中心になります。

jsprimerのContributorを募集しています

今回のjsprimerのES2024の対応を手伝ってくれるContributorを募集しています！

先ほども書いていましたが、おおよそざっくり12-20日ぐらいのタスクがあります。
jsprimerは文章のプロジェクトですが、textlintでのチェックやテストも多いので、必要以上に恐れずに手伝ってくれると嬉しいです。

Node.jsのユースケースの更新は、Node.jsの新しい機能を使うように変更するというのが主なので、そこに興味がある方は特に歓迎です。
こちらは、文章の意味合いはあまり変える必要はないので(コードが変わるのでそれに合わせた変更や流れの調整は必要です)、比較的やりやすいかと思います。

ただし、Node.jsはタスク間の依存関係がちょっとややこしいところが複数人だとちょっとやりにくいかもれないです。
(文章を自然に読めるようにするために未知のことに依存させないという方針なので、文章の並び替えが必要になります)

• Meta: Node.jsのユースケースの更新 · Issue #1719 · asciidwango/js-primer

もし、やってみたい方とかがいれば、一度認識合わせのためにMTGしたり、レビューとかは当然やるのでコメントなどでお知らせください。

(もちろん 他のIssueへのContirbutionはいつでも歓迎しています！)

[koralle]

今回のjsprimerのES2024の対応を手伝ってくれるContributorを募集しています！

初めまして！koralle（こーらる）です。
こちらぜひお手伝いしたいです！

[yossydev]

初めまして！ぜひお手伝いさせていただきたいです！

[azu]

@koralle @yossydev ありがとうございます！
このissueやりたい！というものはあったりしますか？（逆にこのIssueよくわからないとかでも大丈夫です）

特になければ、とりあえず自分が一回ざっと話してみて、興味あるもの選んでもらうのがいいかなと思っていますがどうでしょうか？
ここでやってたようなVideo Meetingするイメージです。
https://github.com/asciidwango/js-primer/tree/master/meetings

[koralle]

@azu
可能であればES2024対応やってみたいです！

これは可能でしょうか...??
#1716

[azu]

@koralle はい大丈夫です！
Object.groupBy の方はreduceの後ろあたりにセクションを追加して書くのがシンプルなのかなと思ってます。
Map.groupBy はちょっとどうするか悩みどころです

[koralle]

@azu

Object.groupBy の方はreduceの後ろあたりにセクションを追加して書くのがシンプルなのかなと思ってます。

レスポンス遅くなってしまいすみません。
これってもう早速手をつけ始めてしまって問題ないでしょうか？

[azu]

@koralle 他のものには特に依存してないので、大丈夫ですよ

[koralle]

ありがとうございます。
では進めていきます。

[SotaYamaguchi]

はじめましてです！
私も是非参加させて頂きたいです！
着手するタスクについては、［Node.jsのユースケースの更新］のどれかあたりから取れればと考えていますmm

[windchime-yk]

はじめまして！ WhyKと申します。
是非お手伝いしたいです！
個人的には、『Node.jsのユースケースの更新』の『mochaをnode:testに変更する』に興味があります！

[jp-knj]

ES2024 対応に興味があります。参加させていただけないでしょうか？

こちらの issue をやってみたいなと考えています。

• utils.parseArgsの利用法を追記 #1698

[azu]

@yossydev @SotaYamaguchi @windchime-yk @jp-knj
Node.jsの方に興味に持っていただきありがとうございます。
多分一斉にやると間違いなくConflictすると思います。

• Meta: Node.jsのユースケースの更新 #1719

次の3つはおそらく順番にやらないと、作業途中(それぞれのIssueが解決されてる段階でも読める状態にしたい)の文章が意味わからない感じになるかなと思ってます。

• npm initとcommonjsの件を「コマンドライン引数を処理する」から「Node.jsでHello World」に移動する #1731
  • utils.parseArgsの利用法を追記 #1698
    • mochaを node:test に変更する #1717

どうやるのが最適ですかね?

1. それぞれのIssueにAssignしていって、互いにreviewしながら一つずつ進める

• 依存してるissueが解決されるまで待ち時間がある

2. 一度 tempなbranchを用意してそこにマージしていって、まとめてマージする

• conflictが起きること自体は解決されない

(Node.jsの変更は順番を変えたりが必要で、全体像を見ながら進めた方が読んでて違和感ないものができると思うので、AssignされたIssue以外も見ながらやるのが良いかなーとは思っています)

まとめ(追記)

• 変更箇所とIssueの対応: ES2024に対応するIssueへのContributorを募集しています #1727 (reply in thread)
• 一時的にまとめるブランチ: v6-node-updates へPRを出す

[azu]

アウトラインを整理して、Issueごとに変更する場所を可視化してみました。

• https://efcl.notion.site/Node-js-7ff26cae41da41c194abe1ac3b698a28?pvs=74

それぞれのIssueで変更する箇所を 色で分けています。

• 🟢 utils.parseArgsの利用法を追記 #1698
  • commander → node:util の parseArgs を使うように変更
    • node: を初めて使うタイミングが早まるので、 node: の説明 を fsモジュールから移動させる
  • npm install をする初めてのタイミングが marked までずれてしまうので、 markedパッケージをインストール を新しく作って、npm installの説明をここに移動させる
    • 中身は大体 commander のインストールとほぼ同じ
• 🟣 mochaを node:test に変更する #1717
  • mocha → node:test に変更する
  • 他の変更とはあまり関係なくできるかも
    • package.json のconflictだけは起きるけど、文章の変更は他とは独立してる
  • ただしマージするタイミングは、 utils.parseArgsの利用法を追記 #1698 の後になる (文章だけのマージなら独立してそうだった)
• 🟠 markedjsのアップデート #1694
  • 多分変更点は一番少ないはず
    • 文章的な変更はほとんどないはず? (GFMのデフォルトとかの調査は必要)
  • ほかの作業の重なる部分も変更が必要なので、一番最後にやった方が良さそう
    • markedパッケージをインストールが増えてからバージョン部分だけいじる
    • ユニットテストを記述する

この2つは、並行してやってもそこまでConflictしない感じはします(package.jsonだけ多分Conflictしますが、installしなおせば治る)。マージするタイミングは #1698 → #1717 になります。

• utils.parseArgsの利用法を追記 #1698
• mochaを node:test に変更する #1717

markedのアップデートは、他の2つが終わってからが楽かなと思います。

• markedjsのアップデート #1694

---

• utils.parseArgsの利用法を追記 #1698

こちらが変更範囲が多いので、 @yossydev さん と @jp-knj さんにお願いしたいです。
(ちょっとどう分担するかのアイデアは出てこなかったです。すみません)

• mochaを node:test に変更する #1717

こちら @windchime-yk さんにお願いしたいです。

• markedjsのアップデート #1694

こちら @SotaYamaguchi さんにお願いしたいです。
ちょっとアップデートでどういう変更が必要かが見えてないので、アップデートしてみて文章やテストを変更しないといけない箇所を調べるところからやるのが良いと思います。

cc @lacolaco

[jp-knj]

@azu

どうやるのが最適ですかね?

2. 一度 tempなbranchを用意してそこにマージしていって、まとめてマージする

私個人の感想なのですが、2 で良さそうだなって思ってます。
すべての変更が一つのブランチに集約されるため、全体像を把握しやすそうです。
互いの作業がどのように連携しているかを理解しそうだなって思っちゃいました。

私が担当することになる issue は、どのみち at yossydev さんとコンフリクトしやすくなりそうなので、
コンフリクトを承知で進めてていきたいなと考えてます。多くの変更が一つのブランチに統合されると、コンフリクトが複雑になりそうなので、そこらへん、気をつけて進めていけば、解決できそうかなだなと捉えてます。（希望的観測ですが）

(ちょっとどう分担するかのアイデアは出てこなかったです。すみません)

いえ、ありがとうございます！

[azu]

一応 v6-node-updates というブランチを切っておきました
PRを出すときに、PRの向き先を v6-node-updates にしておいて、 v6-node-updates を master にマージし直す感じですかね。

📝 特にすぐマージしても問題ないやつ(ES2024とかマージ順は特に関係ないもの)は直接masterにPR出して問題ないです。

[himanoa]

こんにちは！是非お手伝いさせていただきたいです！
興味あるIssueは #1714 です

[azu]

@himanoa ありがとうございます！ OKです！