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
_______________________________________________
Gen-art mailing list
[email protected]
https://www.ietf.org/mailman/listinfo/gen-art

Reply via email to