博士

ねえロボ子、良質な製品には明確なドキュメントが必要だって、知ってたかのじゃ？

ロボ子

はい、博士。それは基本ですよね。今回の記事では、リリースノートの重要性について触れられていますね。

博士

そうそう！詳細で有益なリリースノートは、ユーザーにとって宝の山なのじゃ！`maketgz`スクリプトってのが、ファイルシステムからリリースtarballを作るらしいぞ。

ロボ子

`maketgz`ですか。コンテナ化された`dmaketgz`というバージョンもあるんですね。完全に再現可能なリリースtarballを構築できるとは、すごいですね。

博士

じゃろ？さらに`verify-release`スクリプトは、リリースtarballの中身がgitリポジトリと関連ツールだけから来てるか検証するらしい。

ロボ子

セキュリティ面でも安心ですね。それから、`release-notes.pl`スクリプトは、変更点や修正点を詳しく記述した`RELEASE-NOTES`ファイルを生成するんですね。

博士

そう！curlのgitコミットメッセージ標準に従って、`git log`コマンドで前回の同期以降の変更をリストアップするのじゃ。コミットメッセージの最初の行がリリースノートのエントリになるらしいぞ。

ロボ子

issue trackerへの参照をリンクしてくれるのも便利ですね。でも、スクリプト実行後には手動で確認が必要なんですね。

博士

不要なエントリを削除したり、変更リストを調整したりする手間は惜しんじゃいかんぞ。`release-notes.pl cleanup`は、リリースノートファイルを整理してくれるらしい。

ロボ子

バグ修正リストをソートしたり、孤立した参照を削除したりしてくれるんですね。細かい作業を自動化してくれるのは助かります。

博士

`contributors.sh`スクリプトは、最新リリース以降の貢献者を抽出してくれるらしいぞ。名前を整理して`RELEASE-NOTES`にコピー＆ペーストしやすい形式で出力してくれるなんて、気が利いてるのじゃ！

ロボ子

本当にそうですね。`delta`スクリプトは、最新リリースと比較したリポジトリのデータとカウンターを出力するんですね。

博士

リリースノートファイルの先頭にあるカウンターを更新するのも忘れずにの。そして、`RELEASE-NOTES`ファイルをコミットメッセージ "RELEASE-NOTES: synced" でコミットするのじゃ。

ロボ子

これで自動化に最終更新を知らせることができるんですね。最新のリリースノートはcurlのウェブサイトで公開されているんですね。

博士

`~/.gitconfig`ファイルに`latest = log @^{/RELEASE-NOTES:.synced}..`というエイリアスを設定すると、前回のリリースノート更新以降の変更をリストアップできるらしいぞ。

ロボ子

便利ですね！リリースノートの更新頻度は、変更の量や前回の更新からの経過日数によって決まるんですね。

博士

そう！curlのリリース時には、リリースノートが完全に更新されて、適切に同期されていることを確認することが重要じゃ。

ロボ子

今回の記事で、リリースノートの作成と管理がいかに重要かよくわかりました。博士、ありがとうございました。

博士

どういたしまして。ところでロボ子、リリースノートって、まるでソフトウェアの取扱説明書みたいじゃな。でも、取扱説明書を読まない人が多いのは、なぜかのじゃ？

ロボ子

それは…、読まなくてもなんとなく使えるから、でしょうか？

博士

ぶっぶー！正解は、「取扱説明書を読むためのリリースノートがないから」じゃ！