Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jaxrs-dev] Committer Conventions
  • From: Sebastian Daschner <mail@xxxxxxxxxxxxxxxxxxxxxx>
  • Date: Sun, 1 Apr 2018 08:00:08 +0200
  • Autocrypt: addr=mail@xxxxxxxxxxxxxxxxxxxxxx; keydata= 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 FhOK+a9jGrI=
  • Delivered-to: jaxrs-dev@xxxxxxxxxxx
  • List-archive: <https://dev.eclipse.org/mailman/private/jaxrs-dev>
  • List-help: <mailto:jaxrs-dev-request@eclipse.org?subject=help>
  • List-subscribe: <https://dev.eclipse.org/mailman/listinfo/jaxrs-dev>, <mailto:jaxrs-dev-request@eclipse.org?subject=subscribe>
  • List-unsubscribe: <https://dev.eclipse.org/mailman/options/jaxrs-dev>, <mailto:jaxrs-dev-request@eclipse.org?subject=unsubscribe>
  • Openpgp: preference=signencrypt
  • User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.7.0

Hi all,

My opinions on that:

1) Yes, one week sounds reasonable to me.
2) I think any changes more complex than trvivial typos, small parts of docs, etc. should be reviewed (briefly).
3) I don't really have an opinion on that topic; I'm fine with the proposal.
4) Yes. Automate everything :-)

Cheers,
Sebastian
   


On 03/31/2018 06:59 PM, Markus KARG wrote:

Hi Committers,

 

Christian and I want do discuss the following questions with you! :-)

 

 

(1) Minimum Length of review period before merge / close of PR

 

We should define an aboslute minimum review period so all interested committers had a fair chance to review / vote on each PR before it gets finally merged / closed. Current proposal is one week. A shorter period makes it unnecessarily hard for some committers to review (e. g. when on business travel). A longer period reduces overall agility of the project a lot, particularly when subsequent PRs are interrelated / ontop of each other, hence slows down authors.

 

 

(2) May a comitter merge his own PRs (hence be also the assignee)?

 

If I merge my own PR, I might do not be as critical wrt to quality, IP checks, project rules, and so on, compared to the case where I merge other PRs. So it might be a good thing that "the red (green) button" is not pressed by myself -- just as if I would not be a committer. On the other hand, if I distrust myself, why do I have commit rights?

 

 

(3) May a committer review his own PRs?

 

Technically Githubs counts reviews only if the review tool was used. So if we need three committer reviews, this means three people pressing that particular button. But Github does not allow the contributing committer to review his own code. Not even another committer can add the originally authoring committer as a reviewer. I assume by good reason: The paranoia I outlined in (2). So shall we enforce that even a committer needs three other committers as reviewers, or do we want to allow committers an "implied +1", i. e. enforcing only TWO reviews in that case? Proposal: Allow to reduce reviewers from 3 to 2 for commiter-opened PRs as we trust committers do not start a PR overhastily.

 

 

(4) Shall we enforce Github code reviews technically?

 

Github can prevent us from merging if we have too few reviews. Do we want that? The proposal is: Yes.

 

 

What do you think?

 

-Markus

 

From: Christian Kaltepoth [mailto:notifications@xxxxxxxxxx]
Sent: Samstag, 31. März 2018 10:39
To: eclipse-ee4j/jaxrs-api
Cc: Markus KARG; Mention
Subject: Re: [eclipse-ee4j/jaxrs-api] First version of .travis.yml (#611)

 

Hi @mkarg,

thanks for your comment. Let me respond on a few things:

This PR was merged after just two (not three) positive reviews

Correct, there are only two reviews. But merging requires three committers agreeing on a change. In this case the PR author is also a committer and therefore I think that creating a pull request for a change can be defined as an implicit +1 vote by the author. Therefore, if a PR is created by a committer, only two additional reviews are required. Does this make sense?

after just two days of review period.

I agree that merging was performed too early. Sorry about that. I didn't check the date and actually thought the PR was open for review longer than just two days. Seems like my mind tricked me. Maybe because I started the first discussion about this about a week ago.

However, we talked about voting times back then on the mailing list and didn't agree on any specific period. Some people wrote that one week is fine, others preferred two weeks. I guess that was also the reason for @spericas to not include it in the wiki page. But we should definitely define something for that.

Is it ok to assign my own PRs to myself?

Good question. IMO this is fine. We defined the assignee as a committer who is "in charge". So my impression was that in case of a PR which was created by a committer, it would be fine if the author assigns the PR to himself. However, I agree that there are also good arguments for separating author and assignee. Maybe we should really discuss this on the list.

Is it ok to review my own PRs?

You cannot review your own pull request using GitHub. But if a committer creates a PR, we could count that as a review. At least in my opinion.

To sum up. Perhaps we should really discuss some of these things on the list.


You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub, or mute the thread.



_______________________________________________
jaxrs-dev mailing list
jaxrs-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/jaxrs-dev


Back to the top