xen-devel.lists.xenproject.org archive mirror
 help / color / mirror / Atom feed
From: Andrew Cooper <andrew.cooper3@citrix.com>
To: Jan Beulich <JBeulich@suse.com>, Feng Wu <feng.wu@intel.com>
Cc: Lars Kurth <lars.kurth.xen@gmail.com>,
	xen devel <xen-devel@lists.xenproject.org>,
	"community.manager@xenproject.org"
	<community.manager@xenproject.org>
Subject: Re: [xen 4.6 retrospective] Possible solution together with the comments will be helpful
Date: Mon, 31 Aug 2015 14:47:13 +0100	[thread overview]
Message-ID: <55E45AE1.2040709@citrix.com> (raw)
In-Reply-To: <55E42D72020000780009E33C@prv-mh.provo.novell.com>

On 31/08/15 09:33, Jan Beulich wrote:
>>>> On 31.08.15 at 10:24, <feng.wu@intel.com> wrote:
>> = Issue / Observation =
>> Sometimes the review comments are quite open, it doesn't contain a possible 
>> solution or a clear direction,
>> so it is not clear for the contributor on how to effectively address them. 
>> At least, in Linux kernel and KVM side, if the maintainers have
>> objection to the implementation of the patches, they will give a possible 
>> solution or a direction which is very
>> helpful for the contributor to address the comments. Hence this will make 
>> the review discussion more effective and productive and save both reviewer 
>> and developer's time.
>>
>> = Possible Solution / Improvement =
>> Try to give some possible solutions with the comments, especially for some 
>> big changes which affect a lot
>> to the whole patch-set.
> I think when a solution can be thought of in the context of reviewing,
> it is being given. I believe I know which case you allude to here, and
> I'm afraid it's not always reasonable for the reviewer(s) to do the
> contributor's work of finding a solution when none is obvious.

Personally, I always try to state clearly when I can't suggest a solution.

Having said that, it is easy to make assumptions about the way a
reviewee will interpret a comment.  I expect this most likely comes down
to existing knowledge of related areas, meaning that the same review
comment might be fine for one contributor, and confusing to another.

Again, I do my best to try and be as clear as I can, but I am aware that
I don't always manage it.  My apologies if this is the case.

If anything is not clear, the best action is to ask a direct question on
the relevant thread, even if it as simple as "I am sorry, but I do not
understand this comment".  I certainly, and I expect all reviewers, will
be far happier answering a question to aid with clarity, than for the
contributor to go away and have a stab in the dark and come back with a
v$N+1 which most likely needs further work.

~Andrew

  parent reply	other threads:[~2015-08-31 13:47 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-08-31  8:24 [xen 4.6 retrospective] Possible solution together with the comments will be helpful Wu, Feng
2015-08-31  8:33 ` Jan Beulich
2015-08-31 12:17   ` Lars Kurth
2015-08-31 12:33   ` Wei Liu
2015-08-31 13:47   ` Andrew Cooper [this message]
2015-09-01 14:12   ` George Dunlap

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=55E45AE1.2040709@citrix.com \
    --to=andrew.cooper3@citrix.com \
    --cc=JBeulich@suse.com \
    --cc=community.manager@xenproject.org \
    --cc=feng.wu@intel.com \
    --cc=lars.kurth.xen@gmail.com \
    --cc=xen-devel@lists.xenproject.org \
    /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).