Re: Guidelines for authors and reviewers

"Joel M. Halpern" <jmh@joelhalpern.com> Sat, 31 May 2008 00:12 UTC

Return-Path: <ietf-bounces@ietf.org>
X-Original-To: ietf-archive@megatron.ietf.org
Delivered-To: ietfarch-ietf-archive@core3.amsl.com
Received: from [127.0.0.1] (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id A29C23A6910; Fri, 30 May 2008 17:12:54 -0700 (PDT)
X-Original-To: ietf@core3.amsl.com
Delivered-To: ietf@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 02D113A6C34 for <ietf@core3.amsl.com>; Fri, 30 May 2008 17:12:53 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Level:
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-2.599]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id GKNOUgIGQbSo for <ietf@core3.amsl.com>; Fri, 30 May 2008 17:12:52 -0700 (PDT)
Received: from bender-mail.tigertech.net (bender-mail.tigertech.net [64.62.209.30]) by core3.amsl.com (Postfix) with ESMTP id 1F27F3A688D for <ietf@ietf.org>; Fri, 30 May 2008 17:12:52 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by bender.tigertech.net (Postfix) with ESMTP id 3880D7E3C for <ietf@ietf.org>; Fri, 30 May 2008 17:12:52 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at bender.tigertech.net
Received: from [192.168.1.3] (pool-71-163-24-2.washdc.fios.verizon.net [71.163.24.2]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by bender.tigertech.net (Postfix) with ESMTP id B54B17DA4 for <ietf@ietf.org>; Fri, 30 May 2008 17:12:50 -0700 (PDT)
Message-ID: <484097E7.3080603@joelhalpern.com>
Date: Fri, 30 May 2008 20:12:23 -0400
From: "Joel M. Halpern" <jmh@joelhalpern.com>
User-Agent: Thunderbird 2.0.0.14 (Windows/20080421)
MIME-Version: 1.0
To: IETF Discussion <ietf@ietf.org>
Subject: Re: Guidelines for authors and reviewers
References: <483F2881.40306@ericsson.com> <p06240601c465eaec8585@[129.46.226.27]> <484088F5.8080808@joelhalpern.com> <p0624060ac4663bc97930@[129.46.226.27]>
In-Reply-To: <p0624060ac4663bc97930@[129.46.226.27]>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: IETF Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/pipermail/ietf>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Sender: ietf-bounces@ietf.org
Errors-To: ietf-bounces@ietf.org

Comment inline, with most of the discussion elided.  I believe that one 
particular question gets to the heart of what is bothering me.

Ted Hardie wrote:
> At 4:08 PM -0700 5/30/08, Joel M. Halpern wrote:
...
>> On design decisions, there is an even more complex tradeoff.  I have
>> reviewed several documents which had questionable design decisions.  In
>> one review I recently wrote that I did not expect the following comment
>> to change the WG consensus, but that I considered the specific mechanism
>> used by the document a bad idea.  If I had not known that the particular
>> mechanism had been discussed, I might have put it more forcefully.
>> On the other hand, a while back I reviewed a document which had a
>> mechanism which, although the working group had indeed agreed on it,
>> fundamentally didn't work.  I don't care how much they agreed.  It
>> needed to be changed.  And they changed it.  (It was incumbent upon me
>> to provide a clear and coherent explanation of why it was broken.)
> 
> These both sound like excellent reviews:  you expressed your personal
> design preferences in the first instance but did not try to force it over
> the consensus of the working group, and pointed out a showstopper
> in the second. 
> 
> Now, show me in this draft how these two cases are distinguished,
> which is critical to getting a review done right? 

The problem I have is that I do not know how to write text in a draft 
that distinguishes those two.  The line between them is very tricky, and 
possibly subjective.
And part of the problem is to avoid turning it into a fight.  If all 
review comments get clear, reasonably timely responses, there is room 
for the discussion without acrimony.

Would it address your concern if the document said something like:
    "Reviewers should be sensitive to the difference between
    their personal opinions (and preferences) and issues
    which will affect the correct operation or interoperation
    of the documents under review"
?

I have no problem with pointing out that there are two different 
categories.  I have real problems with trying to define a hard line 
which distinguishes them.

Yours,
Joel

PS: While there are other differences in our views, they seem to be 
questions on which reasonable folk may differ and we can let the 
community sort out how to write the wording.
_______________________________________________
IETF mailing list
IETF@ietf.org
https://www.ietf.org/mailman/listinfo/ietf