Skip to content

Comments

Add section about expectations for merging PRs#147

Merged
Bisaloo merged 3 commits intomainfrom
pr-process
Mar 24, 2025
Merged

Add section about expectations for merging PRs#147
Bisaloo merged 3 commits intomainfrom
pr-process

Conversation

@Bisaloo
Copy link
Member

@Bisaloo Bisaloo commented Mar 10, 2025

Fix last item from #21.

I was reminded of this as we faced this situation today with @Karim-Mane.

@Bisaloo Bisaloo requested a review from sbfnk March 10, 2025 12:52
@netlify
Copy link

netlify bot commented Mar 10, 2025

Deploy Preview for playful-gelato-7892ba ready!

Name Link
🔨 Latest commit 78f197e
🔍 Latest deploy log https://app.netlify.com/sites/playful-gelato-7892ba/deploys/67e187f681299d0008558ddc
😎 Deploy Preview https://deploy-preview-147--playful-gelato-7892ba.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

## Who merges the pull request?

By convention, the package maintainer is in charge of merging the pull requests.
This is indeed often more convenient as they are aware of other ongoing activities in the package that may impact or be impacted with the incoming changes.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
This is indeed often more convenient as they are aware of other ongoing activities in the package that may impact or be impacted with the incoming changes.
This is because they are aware of other ongoing activities in the package that may impact or be impacted with the incoming changes.

or else say more convenient than what

This is indeed often more convenient as they are aware of other ongoing activities in the package that may impact or be impacted with the incoming changes.
We also have a guarantee that maintainers have sufficient permissions to merge the pull request, and potentially bypass some checks if necessary, which may not be the case of the contributor.

This recommendation remains valid even if the maintainer if the author of the pull request and they request review from a non-maintainer.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
This recommendation remains valid even if the maintainer if the author of the pull request and they request review from a non-maintainer.
This recommendation remains valid even if the maintainer is the author of the pull request and they request review from a non-maintainer.


This recommendation remains valid even if the maintainer if the author of the pull request and they request review from a non-maintainer.

As a contributor, if you want to signal your changes are not ready to be merged, you should mark your pull requests as draft.
Copy link
Member

Choose a reason for hiding this comment

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

I like that this is mentioned. Do we also want to consider explicitly tagging a reviewer before reviewing can begin or can people just review if they feel the need to? I think the former introduces a little bit of friction but solves the issue where a PR seems to be open for review but is not ready or is still being actively worked on. The other solution would be to only open a PR for review after it was previously set to draft.

Comment on lines +95 to +97
As a maintainer, if you see a non draft pull request that looks like it might still receive additional changes, please check in with the contributor before proceeding with the merge.
Conversely, if a PR is marked as draft but seems ready to go, you can check in with the contributor if they have additional changes to make or if the PR can be marked as ready for review.
As a contributor, you can also check in with the maintainer to ensure they have not simply forgotten to merge the changes, especially if they already have approved the PR.
Copy link
Member

Choose a reason for hiding this comment

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

And if the author is unresponsive?

Copy link
Member Author

@Bisaloo Bisaloo Mar 24, 2025

Choose a reason for hiding this comment

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

I'm not sure we can have a policy for this. I suspect it will have to be dealt with on a case by case basis depending on who is unresponsive, who is trying to get something merged, what the exact circumstances, etc.

If you have a specific suggestion, please propose a follow up PR.

@Bisaloo Bisaloo merged commit 659aba0 into main Mar 24, 2025
5 checks passed
@Bisaloo Bisaloo deleted the pr-process branch March 24, 2025 16:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants