Skip to content

Clarify which commit hash is used for backporting #254

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 7, 2017

Conversation

Mariatta
Copy link
Member

Move Backporting Merged Changes section to right after the Accepting and Merging a Pull Request

Closes #238

Move ``Backporting Merged Changes`` section to right after the ``Accepting and Merging a Pull Request``

Closes python#238

The commit hash for backporting is the squashed commit that was merged to
the ``master`` branch. On the merged pull request, scroll to the bottom of the
page. Find the event that says something like::
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I resolved conflict while cherry-picking to 3.6 branch, I want to use squash commit of 3.6 branch
for backporting to 3.5.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When backporting the squashed commit from master, we get to keep the reference to the original PR on master, so bedevere-bot can remove the needs backport to .. labels.

Does this happen when backporting from 3.6 to 3.5?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It should - the trick in this case is that the "needs backport to 3.5" label should go on the backport PR against the 3.6 branch, rather than the original PR against master.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this makes things complicated for everyone.
If a core dev wants to backport from 3.6 to 3.5, they can do that at their own discretion, while making sure that labels are updated accordingly.
For everyone else (non core-devs backporting their own PR) I think it's best to recommend backporting from master.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, the only time it makes sense if when the backport from master fails, and even then, it only applies for security fixes, or the times when we have two full maintenance branches open (i.e. from beta 1 of the upcoming stable through to the release of that branch and the subsequent final full maintenance release of the now previous stable branch).

However, now that we branch at beta, we're likely to spend around 1/3rd of the time in that state.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Mariatta Clarifying: I don't think the above needs to be covered in this PR, but there are cases where we want to do X.Y -> X.Y-1 backports, rather than backporting directly from master.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks :) I'm going to merge this.

@Mariatta Mariatta merged commit 5458b05 into python:master Sep 7, 2017
@Mariatta Mariatta deleted the issue-238 branch September 7, 2017 02:46
AA-Turner pushed a commit to AA-Turner/devguide that referenced this pull request Jun 17, 2022
- Clarify which commit hash is used for backporting
- Move ``Backporting Merged Changes`` section to right after the ``Accepting and Merging a Pull Request``
- Mention the git fetch upstream & git rev-parse combo

Closes python#238
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants