Skip to content
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

doc: contribute: remove need to fix new style immediately #84178

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

Conversation

marc-hb
Copy link
Collaborator

@marc-hb marc-hb commented Jan 17, 2025

Follow-up to review of commit ea4e46d ("doc: contribute: Extend Reviewer Expectations with additional rules") where this was already discussed.

It is not really realistic to request that new guidelines be applied immediately all across the tree and it would also go against the "smaller PRs" guideline. It should be possible to implement new rules more gradually.

Also clarify that new rules can be enforced only after they've been merged.

Follow-up to review of commit ea4e46d ("doc: contribute: Extend
Reviewer Expectations with additional rules") where this was already
discussed.

It is not really realistic to request that new guidelines be applied
immediately all across the tree immediately and it would also go against
the "smaller PRs" guideline. It should be possible to implement new
rules more gradually.

Also clarify that new rules can be enforced only after they've been
merged.

Signed-off-by: Marc Herbert <[email protected]>
Comment on lines +373 to +375
a reason for a request for changes. The reviewer can optionally propose and
document new guidelines or rules, and then enforce them after they've been
evaluated, reviewed, agreed and merged.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Question: wouldn't it be better to move the clause to the section starting at line 377?
Since we point there that reviewers should be able to list out the rules/guidelines, we may also mention that if there is no such rule then reviewer is allowed to form one? Any opinions?

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.

5 participants