Re: [Gen-art] Gen-ART review of draft-ietf-conex-concepts-uses-04.txt

Bob Briscoe <bob.briscoe@bt.com> Wed, 04 April 2012 17:45 UTC

Return-Path: <bob.briscoe@bt.com>
X-Original-To: gen-art@ietfa.amsl.com
Delivered-To: gen-art@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 6501C11E8072 for <gen-art@ietfa.amsl.com>; Wed, 4 Apr 2012 10:45:20 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.332
X-Spam-Level:
X-Spam-Status: No, score=-2.332 tagged_above=-999 required=5 tests=[AWL=0.267, BAYES_00=-2.599]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id S6iaC5JM-6BM for <gen-art@ietfa.amsl.com>; Wed, 4 Apr 2012 10:45:20 -0700 (PDT)
Received: from hubrelay-by-03.bt.com (hubrelay-by-03.bt.com [62.7.242.139]) by ietfa.amsl.com (Postfix) with ESMTP id EFE5811E808D for <gen-art@ietf.org>; Wed, 4 Apr 2012 10:45:19 -0700 (PDT)
Received: from EVMHR71-UKRD.domain1.systemhost.net (10.36.3.109) by EVMHR03-UKBR.bt.com (10.216.161.35) with Microsoft SMTP Server (TLS) id 8.3.159.2; Wed, 4 Apr 2012 18:45:16 +0100
Received: from dyw02134app01.domain1.systemhost.net (193.113.249.13) by EVMHR71-UKRD.domain1.systemhost.net (10.36.3.109) with Microsoft SMTP Server (TLS) id 8.3.213.0; Wed, 4 Apr 2012 18:45:16 +0100
Received: from cbibipnt05.iuser.iroot.adidom.com (147.149.196.177) by dyw02134app01.domain1.systemhost.net (10.35.25.214) with Microsoft SMTP Server id 14.2.247.3; Wed, 4 Apr 2012 18:45:07 +0100
Received: From bagheera.jungle.bt.co.uk ([132.146.168.158]) by cbibipnt05.iuser.iroot.adidom.com (WebShield SMTP v4.5 MR1a P0803.399); id 1333561522985; Wed, 4 Apr 2012 18:45:22 +0100
Received: from MUT.jungle.bt.co.uk ([10.215.130.204]) by bagheera.jungle.bt.co.uk (8.13.5/8.12.8) with ESMTP id q34Hj2w6005980; Wed, 4 Apr 2012 18:45:02 +0100
Message-ID: <201204041745.q34Hj2w6005980@bagheera.jungle.bt.co.uk>
X-Mailer: QUALCOMM Windows Eudora Version 7.1.0.9
Date: Wed, 4 Apr 2012 18:45:06 +0100
To: Alexey Melnikov <alexey.melnikov@isode.com>
From: Bob Briscoe <bob.briscoe@bt.com>
In-Reply-To: <4F7C803F.2040308@isode.com>
References: <4F7C803F.2040308@isode.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; format=flowed
X-Scanned-By: MIMEDefang 2.56 on 132.146.168.158
Cc: Nandita Dukkipati <nanditad@google.com>, General Area Review Team <gen-art@ietf.org>, j.schoenwaelder@jacobs-university.de, Alissa Cooper <acooper@cdt.org>, The IESG <iesg@ietf.org>, Richard Woundy <richard_woundy@cable.comcast.com>
Subject: Re: [Gen-art] Gen-ART review of draft-ietf-conex-concepts-uses-04.txt
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: "GEN-ART: General Area Review Team" <gen-art.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gen-art>, <mailto:gen-art-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/gen-art>
List-Post: <mailto:gen-art@ietf.org>
List-Help: <mailto:gen-art-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gen-art>, <mailto:gen-art-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 04 Apr 2012 17:45:20 -0000

Alexey,

Thanks for your review - we are all indebted to people like you who 
commit to review stuff that you don't necessarily have an interest in.


We're concerned if you think the doc isn't understandable without 
reading the I-D refs. This is meant to be the entry-point to the set 
of ConEx documentation, so we intended it to be understandable 
without knowing how ConEx works (beyond the high level description in 
the introduction). "Understandable" here means sufficient to satisfy 
the stated purpose of the doc, which is to motivate ConEx (not to 
understand how it works).

The refs are intended to be used the other way round - having read 
this, you should be motivated to go and read more, so it provides 
pointers to what's available.

Are you sure the need to read the refs is not a symptom of your 
(natural) curiosity to know how ConEx works? Is it really necessary 
to know the details of how ConEx works to understand the motivation 
for building it?

The second paragraph sets out the purpose of the doc:
"
    This document provides the entry point to the set of documentation
    about the Congestion Exposure (ConEx) protocol.  It focuses on the
    motivation for including a ConEx marking at the IP layer.  (A
    companion document, [I-D.ietf-conex-abstract-mech], focuses on the
    mechanics of the protocol.)
"


Bob

At 18:09 04/04/2012, Alexey Melnikov wrote:
>I have been selected as the General Area Review Team (Gen-ART)
>reviewer for this draft. For background on Gen-ART, please see the 
>FAQ at <http://wiki.tools.ietf.org/area/gen/trac/wiki/GenArtfaq>
>
>Please resolve these comments along with any other comments you may receive.
>
>Document: draft-ietf-conex-concepts-uses-04.txt
>Reviewer: Alexey Melnikov
>Review Date: 2012-04-04
>IETF LC End Date: 2012-04-12
>IESG Review: 2012-04-12
>
>Summary: The document is nearly ready for publication as an 
>Informational RFC (see one issue below)
>
>
>Major issues: none
>
>Minor issues:
>
>This might be pedantic, but I think some of your Informational 
>references are actually Normative, because they are needed to 
>understand the document. See "IESG Statement: Normative and 
>Informative References" for more details 
><http://www.ietf.org/iesg/statement/normative-informative.html>.
>
>This almost doesn't matter for an Informational document, however if 
>any of 5 drafts becomes Normative, publication of this document as 
>an RFC will be delayed. Still, this might be better than just 
>getting it published with "work in progress" references.
>
>But otherwise this is a well written document and I enjoyed reading it.
>
>
>Nits/editorial comments: none

________________________________________________________________
Bob Briscoe,                                BT Innovate & Design