Table of Contents
Backporting in WooCommerce
Backporting is the process of applying changes from trunk to a release branch. This ensures critical fixes reach customers in upcoming releases. Note that these flows apply only to UPCOMING RELEASES (not patches to already-released versions).
Release Branch Lifecycle
When a release branch is created, it's copied from trunk at the time of feature freeze. After creation:
- The release branch no longer receives new feature updates
- Only critical changes are allowed
- Because we do not merge the release branches back into
trunk, any fixes in a release branch must also be applied totrunk.
Qualifying Changes for Backporting
変更がバックポートの対象となるのは、変更がバックポートの対象となる場合のみである:
- リリースに影響するバグ修正。
- WooCommerceの機能に影響を与えるパフォーマンスの改善。
- ビジネスゴールに影響するタイムセンシティブ機能。
- WooCommerceのために契約上必要な機能。
Backporting Process for Contributors
Standard Workflow: Trunk to Release Branch
使用する場合: ほとんどのバックポートシナリオ
- Target
trunkas your base branch - Add milestone matching your target release (e.g.,
9.8.0) - Get PR reviewed and merged into
trunk - Automated workflow creates a cherry-pick PR for the release branch
- The original contributor or merger reviews and merges the backport PR
> 注意:** リリース期限間近の緊急修正については、リリースリーダーに直接連絡してください。
Alternative Workflow: Release Branch to Trunk
使用する場合: リリース・ブランチを直接対象としなければならないクリティカルな修正
- Target the release branch as your base branch
- Add label
cherry pick to trunkif the change should also go totrunk - Get PR reviewed and merged into the release branch
- Automated workflow creates a forward-port PR for
trunk - Merge the trunk PR as soon as possible to avoid delays
Important Notes
- 変更はバックポート資格を満たしていなければならない
- 凍結リリースでは、重要なバグ修正のみを受け入れること
- すべてのバックポートにはレビューとテストが必要です。
- トランクへのフォワードポートは、元のPRと同じマイルストーンで追跡されるので、速やかにマージしてください。