Skip to content

Workflows: Improve manual cherry-pick instructions on conflict#76587

Open
Bingtagui404 wants to merge 2 commits intoWordPress:trunkfrom
Bingtagui404:fix/76576-improve-cherry-pick-instructions
Open

Workflows: Improve manual cherry-pick instructions on conflict#76587
Bingtagui404 wants to merge 2 commits intoWordPress:trunkfrom
Bingtagui404:fix/76576-improve-cherry-pick-instructions

Conversation

@Bingtagui404
Copy link

What?

Closes #76576

Improves the manual cherry-pick instructions left as a comment when the automatic cherry-pick workflow fails.

Why?

The current instructions have several usability issues: a generic branch name, unclear whether conflict resolution is needed, no mention of fork support, a non-clickable documentation link, and no GitHub CLI alternative for creating the PR.

How?

Updated the conflict comment template in cherry-pick-wp-release.yml with 5 improvements:

  1. Contextual branch name: Uses cherry-pick/{pr_number}-to-wp-{version} instead of my-branch
  2. Optional conflict resolution: Conflict resolution steps are commented out and noted as conditional
  3. Fork clarification: Added note that the cherry-pick can be done from a fork
  4. Clickable link: Moved the documentation link outside the code block so it renders as a clickable Markdown link
  5. GitHub CLI command: Added gh pr create --base wp/X.Y --web as an alternative to manually setting the base branch

Testing Instructions

  1. This change only affects the GitHub Actions workflow file.
  2. To test, a cherry-pick conflict would need to occur on a PR with a Backport to WP X.Y Beta/RC label.
  3. Verify the resulting comment includes all 5 improvements listed above.

Use of AI Tools

This PR was authored with the assistance of Claude Code (AI coding assistant). The change was reviewed and validated by the contributor.

- Use a contextual branch name instead of `my-branch`
- Mark conflict resolution steps as optional
- Clarify that the cherry-pick can be done from a fork
- Move the documentation link outside the code block for clickability
- Add `gh pr create --base` command as an alternative

Closes WordPress#76576
@Bingtagui404 Bingtagui404 requested a review from desrosj as a code owner March 17, 2026 14:16
@github-actions
Copy link

Warning: Type of PR label mismatch

To merge this PR, it requires exactly 1 label indicating the type of PR. Other labels are optional and not being checked here.

  • Required label: Any label starting with [Type].
  • Labels found: .

Read more about Type labels in Gutenberg. Don't worry if you don't have the required permissions to add labels; the PR reviewer should be able to help with the task.

@github-actions
Copy link

github-actions bot commented Mar 17, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Unlinked Accounts

The following contributors have not linked their GitHub and WordPress.org accounts: @Bingtagui404.

Contributors, please read how to link your accounts to ensure your work is properly credited in WordPress releases.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Unlinked contributors: Bingtagui404.

Co-authored-by: desrosj <desrosj@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@github-actions github-actions bot added the First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository label Mar 17, 2026
@github-actions
Copy link

👋 Thanks for your first Pull Request and for helping build the future of Gutenberg and WordPress, @Bingtagui404! In case you missed it, we'd love to have you join us in our Slack community.

If you want to learn more about WordPress development in general, check out the Core Handbook full of helpful information.

Use array.join() to build the comment body instead of a multiline
template literal, avoiding YAML indentation issues with actionlint.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve the manual git cherry-pick instructions left when performing an automatic cherry-pick fails

1 participant