Merging to Main
Merge Requirements
Before merging, ensure:
- Repository-specific review requirements are complete
- Branch is up to date with main
- No merge conflicts
- Current required CI checks pass
Merge Process
GitHub web interface (recommended):
- Click "Merge"
- Edit the commit message to be clear and descriptive
- Confirm merge
- Delete the source branch automatically (check the box)
Use the repository's protected pull-request merge control. Do not bypass it by pushing a local merge to main.
Post-Merge
Immediately after merging:
- Delete the feature branch (automated via GitHub)
- Verify main branch builds successfully
- Monitor for any issues in deployed environments
- Close any linked issues if not automatically closed
For the RMC Software Documentation repository, only administrators merge to main. Conversation replies and thread resolution are not mandatory gates. A successful merge starts the automatic main production build, which still requires administrator environment approval.
If something breaks:
- Create hotfix branch immediately
- Fix the issue
- Create a PR (can be fast-tracked)
- Merge after quick review
- Consider reverting the original PR if the hotfix is complex