Contributing to patch releases

creating a patch release のプロセスは、おおむね次のとおりです。

  1. 対象となるマイナーリリースブランチ(例:release-1.10)をベースに、新しいブランチ(例:backports-release-1.10)を作成します。通常は、対応するプルリクエストも作成します。
  2. 主に master からコミットをそのブランチに追加します(これが「バックポート」です)。この作業の詳細は後述します。
  3. そのブランチに対して、BaseBenchmarks.jl ベンチマークスイートと PkgEval.jl パッケージエコシステムのテストツールを実行します。通常、BaseBenchmarks.jl と PkgEval.jl は、バックポート用ブランチに関連付けられたプルリクエストから Nanosoldier.jl 経由で実行します。問題があれば修正します。
  4. すべてのテストとベンチマークの結果に問題がないことを確認したら、バックポート用ブランチを対応するリリースブランチにマージします(例:backports-release-1.10 を release-1.10 にマージ)。
  5. 対象のマイナーリリースのバージョンを次のパッチバージョンに上げるプルリクエストを作成します。例:this pull request。
  6. パッチリリースのタグ付けとウェブサイトの更新を依頼するため、@JuliaLang/releases に連絡します。
  7. 対象のマイナーリリースのバージョンを次のプレリリースパッチバージョンに上げるプルリクエストを作成します。例: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 タグを削除してください。