Contributing to patch releases
creating a patch release のプロセスは、おおむね次のとおりです。
- 対象となるマイナーリリースブランチ(例:
release-1.10)をベースに、新しいブランチ(例:backports-release-1.10)を作成します。通常は、対応するプルリクエストも作成します。 - 主に
masterからコミットをそのブランチに追加します(これが「バックポート」です)。この作業の詳細は後述します。 - そのブランチに対して、BaseBenchmarks.jl ベンチマークスイートと PkgEval.jl パッケージエコシステムのテストツールを実行します。通常、BaseBenchmarks.jl と PkgEval.jl は、バックポート用ブランチに関連付けられたプルリクエストから Nanosoldier.jl 経由で実行します。問題があれば修正します。
- すべてのテストとベンチマークの結果に問題がないことを確認したら、バックポート用ブランチを対応するリリースブランチにマージします(例:
backports-release-1.10をrelease-1.10にマージ)。 - 対象のマイナーリリースのバージョンを次のパッチバージョンに上げるプルリクエストを作成します。例:this pull request。
- パッチリリースのタグ付けとウェブサイトの更新を依頼するため、
@JuliaLang/releasesに連絡します。 - 対象のマイナーリリースのバージョンを次のプレリリースパッチバージョンに上げるプルリクエストを作成します。例:this pull request。
上記の手順 2、つまり backports-release-X.Y ブランチへのコミットのバックポートは、Backporter によって大部分が自動化されています。Backporter は、該当する backport-X.Y タグが付いたマージ済みのプルリクエストを検索し、そのコミットを backports-release-X.Y ブランチにチェリーピックしようとします。介入なしで適用できるコミットもあれば、そうでないものもあります。後者のコミットは「手動」でのバックポートが必要となるため、協力していただけると大変助かります。Backporter は、自動でバックポートできたコミットと手動でのバックポートが必要なコミットを示すレポートを生成します。このレポートは通常、backports-release-X.Y に関連付けられたプルリクエストの最初の投稿にコピーされ、自動または手動でコミットが追加でバックポートされるたびに更新されます。
手動でバックポートする場合、必要な権限があれば、バックポートを backports-release-X.Y ブランチに直接プッシュしてください。必要な権限がない場合は、手動バックポートを含むプルリクエストを backports-release-X.Y ブランチに対して作成してください。手動バックポートが backports-release-X.Y ブランチに反映されたら、元のコミットのプルリクエストから backport-X.Y タグを削除してください。