IMPORTANT REMINDER: 2 Reviews (ie approvals) are required for most client-libs changes

Aleksei Ivanov alexey.ivanov at oracle.com
Tue Aug 1 13:21:43 UTC 2023


In some cases, one reviewer may be enough… for some trivial changes, 
perhaps for some test-only updates.

Even in those cases, non-urgent PRs should remain open for *at least 24 
hours* after getting the first approval.

--
Alexey

On 13/07/2023 21:33, Philip Race wrote:
> That would be nice but I suspect it would not be easy to get agreement 
> on that.
>
> At least the dev guide also says "Some teams may require more Reviewers."
> https://openjdk.org/guide/#fixing-a-bug
>
> And it recommends 24 business hrs as well ..
>
> "In general all PRs should be open for at least 24 hours to allow for 
> reviewers in all time zones to get a chance to see it. It may actually 
> happen that even 24 hours isn’t enough. Take into account weekends, 
> holidays, and vacation times throughout the world and you’ll realize 
> that a change that requires more than just a trivial review may have 
> to be open for a while. In some areastrivial 
> <https://openjdk.org/guide/#trivial>changes are allowed to be pushed 
> without the 24 hour delay. Ask your reviewers if you think this 
> applies to your change."
>
> https://openjdk.org/guide/#life-of-a-pr
>
> -phil.
>
> On 7/13/23 1:24 PM, Thomas Stüfe wrote:
>> I think it would be less confusing all around to have a general 
>> requirement for 2 reviewers across the whole OpenJDK.
>>
>> On Thu, Jul 13, 2023 at 5:28 PM Philip Race <philip.race at oracle.com> 
>> wrote:
>>
>>     Please see "Code Reviews" on the Group page
>>     https://openjdk.org/groups/client-libs/ where it says
>>
>>     The Java Client Library Group has always standardized on two
>>     approvals - where at least one must have the Reviewer role.
>>     Historically this was addressed entirely by social conventions
>>     but today the tooling plays a role - and the JDK project is set
>>     up to mark a PR as ready for integration after a single approval
>>     by a person with the Reviewer role - which is not consistent with
>>     the Client Libraries policy.
>>     The tooling cannot automatically enforce this on a per-module
>>     basis and it is not reasonable to expect others to add
>>     "/reviewers 2" to every PR.
>>     The fixer therefore needs to understand the policies and wait for
>>     a second approval.
>>
>>     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>>     As an example of a PR about which there was zero urgency and
>>     should have had a 2nd approval see
>>
>>     https://github.com/openjdk/jdk/pull/14795
>>
>>     -phil.
>>
>




More information about the client-libs-dev mailing list