Skip to content

Add review policy #19988

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add review policy #19988

wants to merge 1 commit into from

Conversation

ahrtr
Copy link
Member

@ahrtr ahrtr commented May 20, 2025

@ahrtr
Copy link
Member Author

ahrtr commented May 20, 2025

Also see #19987 (comment)

@ahrtr ahrtr force-pushed the review_policy_20250520 branch 2 times, most recently from fb5985d to fbaf539 Compare May 20, 2025 12:03
Copy link

codecov bot commented May 20, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 68.16%. Comparing base (6e2be32) to head (c0132db).
Report is 10 commits behind head on main.

Additional details and impacted files

see 35 files with indirect coverage changes

@@            Coverage Diff             @@
##             main   #19988      +/-   ##
==========================================
- Coverage   68.82%   68.16%   -0.66%     
==========================================
  Files         424      424              
  Lines       35762    35762              
==========================================
- Hits        24612    24378     -234     
- Misses       9728     9950     +222     
- Partials     1422     1434      +12     

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6e2be32...c0132db. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Member

@serathius serathius left a comment

Choose a reason for hiding this comment

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

@ahrtr
Copy link
Member Author

ahrtr commented May 20, 2025

#19987 (comment)

Let's discuss in this PR. Which policy you disagree?

@ahrtr
Copy link
Member Author

ahrtr commented May 20, 2025

Hi @fuweid @ivanvc @jmhbnz @serathius @siyuanfoundation let's focus on the policies proposed in this PR. It's based on current status. In future when we integrate K8s's auto merge utility, we can revisit & update this guide by then.

Please share your thoughts, thx

- Approvals should come from a maintainer, reviewer, or submodule owner familiar with the relevant code or area.
- If there’s disagreement, maintainers should discuss and agree before merging.

## Exceptions for Less Impactful PRs
Copy link
Member

Choose a reason for hiding this comment

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

From my perspective, exceptions make the process harder to follow. Sometimes, flaky test cases can make it even worse. We have several active reviewers and maintainers, so requiring two approvals seems reasonable to me.

Copy link
Member Author

Choose a reason for hiding this comment

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

so requiring two approvals seems reasonable to me.

Yes, it's true.

exceptions make the process harder to follow.

That's the reason why I provide a list of examples below.

Copy link
Member Author

Choose a reason for hiding this comment

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

exceptions make the process harder to follow.

For test, it's indeed sometime harder to follow, but let's provide some flexiblities. At least, it won't break the production code.

Copy link
Member Author

Choose a reason for hiding this comment

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

Sometimes, flaky test cases can make it even worse.

Good point! Removed tests from the list.

Copy link
Member

Choose a reason for hiding this comment

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

@ahrtr ahrtr force-pushed the review_policy_20250520 branch from fbaf539 to bd3ddc6 Compare May 20, 2025 19:43
Copy link
Member

@jmhbnz jmhbnz left a comment

Choose a reason for hiding this comment

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

LGTM - Thanks @ahrtr

  • The default rule of two approvals makes sense.
  • An exception of single reviewer for trivial changes like minor doc tweaks makes sense.
  • Completely agree we should not merge code that has not been reviewed.

@k8s-ci-robot
Copy link

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: ahrtr, jmhbnz

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@serathius
Copy link
Member

This PR only needlessly split the discussion.

Copy link
Member

@spzala spzala left a comment

Choose a reason for hiding this comment

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

Thanks @ahrtr !! More clarity with the review process is better. As @jmhbnz mentioned moving it to existing triage_prs.md or https://github.com/etcd-io/etcd/blob/main/CONTRIBUTING.md#get-your-pull-request-reviewed sounds good.

@ahrtr ahrtr force-pushed the review_policy_20250520 branch from bd3ddc6 to 2230691 Compare May 23, 2025 11:41
Signed-off-by: Benjamin Wang <[email protected]>
@ahrtr ahrtr force-pushed the review_policy_20250520 branch from 2230691 to c0132db Compare May 23, 2025 11:44
@k8s-ci-robot
Copy link

@ahrtr: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
ci-etcd-robustness-release36-amd64 c0132db link true /test ci-etcd-robustness-release36-amd64

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@ahrtr
Copy link
Member Author

ahrtr commented May 26, 2025

cc @fuweid @ivanvc @serathius @spzala

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

6 participants