DPDK patches and discussions
 help / color / mirror / Atom feed
From: "Morten Brørup" <mb@smartsharesystems.com>
To: "Thomas Monjalon" <thomas@monjalon.net>,
	"Jerin Jacob" <jerinjacobk@gmail.com>,
	"Burakov, Anatoly" <anatoly.burakov@intel.com>
Cc: "Maxime Coquelin" <maxime.coquelin@redhat.com>,
	"dpdk-dev" <dev@dpdk.org>, <techboard@dpdk.org>,
	"Jim St. Leger" <jim.st.leger@intel.com>
Subject: Re: [dpdk-dev] [dpdk-techboard] Consider improving the DPDKcontribution processes
Date: Mon, 25 May 2020 20:44:37 +0200	[thread overview]
Message-ID: <98CBD80474FA8B44BF855DF32C47DC35C60FF5@smartserver.smartshare.dk> (raw)
In-Reply-To: <11959277.FkLDZFFinP@thomas>

> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Thomas Monjalon
> Sent: Monday, May 25, 2020 6:29 PM
> 
> 25/05/2020 18:09, Burakov, Anatoly:
> > On 25-May-20 5:04 PM, Maxime Coquelin wrote:
> > > On 5/25/20 5:59 PM, Burakov, Anatoly wrote:
> > >> On 25-May-20 4:52 PM, Maxime Coquelin wrote:
> > >>> On 5/25/20 5:35 PM, Jerin Jacob wrote:
> > >>>> On May 25, 2020 Thomas Monjalon wrote:
> > >>>>> My concern about clarity is the history of the discussion.
> > >>>>> When we post a new versions in GitHub, it's very hard to keep
> track
> > >>>>> of the history.
> > >>>>> As a maintainer, I need to see the history to understand what
> happened,
> > >>>>> what we are waiting for, and what should be merged.
> > >>>>
> > >>>> IMO, The complete history is available per pull request URL.
> > >>>> I think, Github also email notification mechanism those to
> prefer to see
> > >>>> comments in the email too.
> > >>>>
> > >>>> In addition to that, Bugzilla, patchwork, CI stuff all
> integrated into
> > >>>> one place.
> > >>>> I am quite impressed with vscode community collaboration.
> > >>>> https://github.com/Microsoft/vscode/pulls
> > >>>
> > >>> Out of curiosity, just checked the git history and I'm not that
> > >>> impressed. For example last commit on the master branch:
> > >>>
> > >>>
> https://github.com/microsoft/vscode/commit/2a4cecf3f2f72346d06990feeb74
> 46b3915d6148
> > >>>
> > >>>
> > >>> Commit title: " Fix #98530 "
> > >>> Commit message empty, no explanation on what the patch is doing.
> > >>>
> > >>> Then, let's check the the issue it is pointed to:
> > >>> https://github.com/microsoft/vscode/issues/98530
> > >>>
> > >>> Issue is created 15 minutes before the patch is being merged. All
> that
> > >>> done by the same contributor, without any review.
> > >>>
> > >>
> > >> Just because they do it wrong doesn't mean we can't do it right :)
> This
> > >> says more about Microsoft's lack of process around VSCode than it
> does
> > >> about Github the tool.
> > >>
> > >
> > > True. I was just pointing out that is not the kind of process I
> would
> > > personally want to adopt.
> > >
> >
> > You won't find disagreement here, but this "process" is not due to
> the
> > tool. You can just as well allow Thomas to merge stuff without any
> > review because he has commit rights, no Github needed - and you would
> be
> > faced with the same problem.
> >
> > So, i don't think Jerin was suggesting that we degrade our
> merge/commit
> > rules. Rather, the point was that (whatever you think of VSCode's
> > review/merge process) there are a lot of pull requests and there is
> > healthy community collaboration. I'm not saying we don't have that,
> 
> Yes, recent survey said the process was fine:
> 	http://mails.dpdk.org/archives/announce/2019-June/000268.html
> 
> 
> > obviously, but i have a suspicion that we'll get more of it if we
> lower
> > the barrier for entry (not the barrier for merge!). I think there is
> a
> > way to lower the secondary skill level needed to contribute to DPDK
> > without lowering coding/merge standards with it.

That is exactly what I am asking for: Lowering the barrier and increasing the feeling of success for newcomers. (The barrier for merge is probably fine; I'll leave that discussion to the maintainers.)

> 
> About the barrier for entry, maybe it is not obvious because I don't
> communicate a lot about it, but please be aware that I (and other
> maintainers I think) are doing a lot of changes in newcomer patches
> to avoid asking them knowing the whole process from the beginning.
> Then frequent contributors get educated on the way.

Great! I wish that every developer would think and behave this way.

> 
> I think the only real barrier we have is to sign the patch
> with a real name and send an email to right list.
> The ask for SoB real name is probably what started this thread
> in Morten's mind. And the SoB requirement will *never* change.

The incorrect Signed-off-by might be the only hard barrier (which we cannot avoid). But that did not trigger me.

I was raising the discussion to bring attention to soft barriers for contributors. What triggered me was the request to split the patch into multiple patches; a kind of feedback I have seen before. For an experienced git user, this is probably very easy, but for a git newbie (like myself), it basically means starting all over and trying to figure out the right set of git commands to do this, which can be perceived as a difficult task requiring a lot of effort.

Perhaps we could supplement the Contributor Guidelines with a set of cookbooks for different steps in the contribution process, so reviewers can be refer newcomers to the relevant of these as part of the feedback. Just like any professional customer support team has a set of canned answers ready for common customer issues. (Please note: I am not suggesting adding an AI/ML chat bot reviewer to the mailing list!)

The amount of Contributor Guideline documentation is also a balance... it must be long enough to contain the relevant information to get going, but short enough for newcomers to bother reading it.


  parent reply	other threads:[~2020-05-25 18:44 UTC|newest]

Thread overview: 41+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-05-25  9:34 [dpdk-dev] Consider improving the DPDK contribution processes Morten Brørup
2020-05-25 11:00 ` Jerin Jacob
2020-05-25 11:12 ` Burakov, Anatoly
2020-05-25 11:58   ` Jerin Jacob
2020-05-25 12:53     ` Thomas Monjalon
2020-05-25 14:28       ` Burakov, Anatoly
2020-05-25 14:55         ` Wiles, Keith
2020-05-25 15:22         ` Thomas Monjalon
2020-05-25 15:35           ` Jerin Jacob
2020-05-25 15:52             ` [dpdk-dev] [dpdk-techboard] " Maxime Coquelin
2020-05-25 15:59               ` Burakov, Anatoly
2020-05-25 16:04                 ` Maxime Coquelin
2020-05-25 16:09                   ` Burakov, Anatoly
2020-05-25 16:28                     ` Thomas Monjalon
2020-05-25 16:57                       ` Wiles, Keith
2020-05-25 17:32                         ` Thomas Monjalon
2020-05-25 17:50                           ` Wiles, Keith
     [not found]                             ` <068c6367-b233-07f9-c038-4bddc4f48106@kth.se>
2020-05-26  9:33                               ` Burakov, Anatoly
2020-05-26 13:12                                 ` Wiles, Keith
2020-05-26 13:10                               ` Wiles, Keith
2020-05-25 18:44                       ` Morten Brørup [this message]
2020-05-25 20:34                         ` [dpdk-dev] [dpdk-techboard] Consider improving the DPDKcontribution processes Thomas Monjalon
2020-05-26  7:06                           ` Tom Barbette
2020-05-26  7:31                             ` Maxime Coquelin
2020-05-26  9:13                               ` Burakov, Anatoly
2020-05-26  9:43                         ` Burakov, Anatoly
2020-05-26 10:16                           ` Jerin Jacob
2020-05-26 10:33                             ` Thomas Monjalon
2020-05-26 10:52                               ` Burakov, Anatoly
2020-05-26 12:45                                 ` Thomas Monjalon
2020-05-26 13:57                                   ` Burakov, Anatoly
2020-05-26 14:01                                     ` Thomas Monjalon
2020-05-26 10:53                               ` Jerin Jacob
2020-05-25 16:01               ` [dpdk-dev] [dpdk-techboard] Consider improving the DPDK contribution processes Jerin Jacob
2020-05-25 15:43           ` [dpdk-dev] " Burakov, Anatoly
2020-05-25 14:55       ` Wiles, Keith
2020-05-25 12:08   ` [dpdk-dev] [dpdk-techboard] " Bruce Richardson
2020-05-25 15:04     ` Burakov, Anatoly
2020-05-25 15:28       ` Jerin Jacob
2020-05-25 15:47     ` Stephen Hemminger
2020-05-25 16:21       ` Bruce Richardson

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=98CBD80474FA8B44BF855DF32C47DC35C60FF5@smartserver.smartshare.dk \
    --to=mb@smartsharesystems.com \
    --cc=anatoly.burakov@intel.com \
    --cc=dev@dpdk.org \
    --cc=jerinjacobk@gmail.com \
    --cc=jim.st.leger@intel.com \
    --cc=maxime.coquelin@redhat.com \
    --cc=techboard@dpdk.org \
    --cc=thomas@monjalon.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).