今日の英語表現 29/30 · ステージ: マージ後 例文はすべてこの記事のために作成したものです。実際のリポジトリのコメントをそのまま持ってきたものではなく、バージョンや番号は例です。
目次
一目でわかるまとめ
| 表現 | This landed in main. / The fix will ship in v1.5.0. |
| 意味 | mainにマージされました / この修正はv1.5.0に載ってリリースされます |
| 使う場面 | issue終了時のコメント、リリース案内、Slack |
| 丁寧さ | 中立。状態を知らせる表現です |
1. 意味とニュアンス
landは「着陸する」という意味です。開発現場ではここから派生して、「変更がレビューを通過してリポジトリのメインブランチに入る」という意味で使います。Chromiumのコントリビューションドキュメントでも、コミットメッセージが変更を「Chromiumツリーにlandedするとき」に使われると言い、親の変更が「mainにlandsする前」という表現を使います。自動詞としてThis landed、他動詞としてI landed the changeのどちらも使います。
マージした後に最もよく受ける質問は「それで、いつ使えるようになりますか?」です。このとき、 マージとリリースを区別して伝えなければなりません。
- landed / merged: mainブランチに入った状態。まだリリースされていない可能性があります。
- released / shipped: リリースに載り、ユーザーが利用できる状態。
- will be in / will ship in (バージョン): 次回のリリースに含まれる予定。
これらを混同して使うと誤解が生じます。ユーザーが「修正された」という言葉だけを聞いて現在のバージョンにアップデートしたにもかかわらず、まだバグが残っている場合、issueが再びオープンされ、不要なやり取りが続くことになります。そのため、issueをクローズする際には、 どのブランチに入り、どのバージョンでリリースされるのかをあわせて記載することをおすすめします。リリースブランチに別途バックポートする必要があるかどうかについては、第30回のbackportで扱います。
2. 例文
状況1: issueをクローズする場合
The fix landed in main via #4210 and will be included in v1.5.0. Closing this, but feel free to reopen if you still see the problem after upgrading.
viaは「〜を経由して」という意味です。feel free to reopenは再度オープンしてもよいという許可であり、クローズの言葉を柔らかくします。
状況2: ユーザーの質問に答える場合
It's merged but not released yet. If you need it now, you can try the nightly build; otherwise it'll ship in the next minor release.
nightly buildは毎晩mainから作成されるテスト用のビルドです。プロジェクトによって呼び方が異なります。
状況3: Slackで嬉しいニュースを知らせる場合
My first PR to the project just landed! Thanks to everyone who reviewed it.
3. 似た表現との違い
- Merged. 最も直接的で誤解を招きません。GitHubの画面上のステータス名と同じです。
- Shipped in v1.5.0. すでにリリースに載って公開されたという意味です。ユーザーはそのバージョンから使用できます。
- Available in v1.5.0 and later. 「v1.5.0以降で利用可能」という意味で、ドキュメントやリリースノートで使われる正確な表現です。
4. 韓国人がよくやりがちなミス
- It is reflected. 「反映された」を直訳すると、何にどう反映されたのかが分かりません(第17回のreflectと同様のミス)。
- 修正した文: The fix has been merged into main.
- It is fixed. Please update. まだリリースされていない場合、ユーザー側でアップデートするバージョンがありません。
- 修正した文: It's fixed in main and will be in v1.5.0.
- This was merged in v1.5.0. マージはブランチで行われるものであり、バージョンはリリース名です。バージョンと一緒に使う場合はincludedやshippedが正確です。
- 修正した文: This is included in v1.5.0. または This shipped in v1.5.0.
5. 1行練習
次の韓国語の文を、issueをクローズする際のコメントに書き換えてください。
この修正はmainにマージされ、次のパッチリリースに含まれます。その時に再度ご確認ください。
模範解答
This fix landed in main and will be part of the next patch release. Please give it a try once it's out.
be part ofは「〜に含まれる」を自然に表現した言い回しです。once it's outは「リリースされたら」という意味で、リリース時期が正確に分からない場合に使うのに適しています。
Titiの一言 「入ったこと(マージ)」と「出たこと(リリース)」は異なります。両者を分けて伝えれば、同じ質問を二度受けることはありません。
参考
- Chromium, Contributing to Chromium(Committing): https://chromium.googlesource.com/chromium/src/+/main/docs/contributing.md
- Merriam-Webster, 「ship」: https://www.merriam-webster.com/dictionary/ship