Return-Path: <in@bobbriscoe.net>
X-Original-To: tsvwg@ietfa.amsl.com
Delivered-To: tsvwg@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1])
 by ietfa.amsl.com (Postfix) with ESMTP id 104573A1657
 for <tsvwg@ietfa.amsl.com>; Tue, 10 Mar 2020 10:28:51 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level: 
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5
 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1,
 DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001,
 SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001]
 autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key)
 header.d=bobbriscoe.net
Received: from mail.ietf.org ([4.31.198.44])
 by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024)
 with ESMTP id ymleo0oxuLr5 for <tsvwg@ietfa.amsl.com>;
 Tue, 10 Mar 2020 10:28:49 -0700 (PDT)
Received: from server.dnsblock1.com (server.dnsblock1.com [85.13.236.178])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by ietfa.amsl.com (Postfix) with ESMTPS id 7DF8A3A1652
 for <tsvwg@ietf.org>; Tue, 10 Mar 2020 10:28:48 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=bobbriscoe.net; s=default; h=Content-Type:In-Reply-To:MIME-Version:Date:
 Message-ID:Cc:From:References:To:Subject:Sender:Reply-To:
 Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:
 Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:
 List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=czPyeaVgHPtdWALDYxg+dVO2xttbRolrZaBNU+3mFUk=; b=6B3lONMbnIYv86bAmTXI7B6je
 VjFQALrpu/hATRjGNNWGjZrKHDxNTu4OP9c9Ht8vUHJKErQnDExtVVhsE3FHsFlXYXaNvWg2CiKxz
 nNl0QpdNYROLL1z80XxeBkh/TgMzxFDhDFDTHwQmGfWNWQusKsOvVHW7Dc1bmwUaF0iLsgLx5ZTPT
 akEb01BJ/mv+5GLO5nOylfuiEo7VPpuzx5+Y42+eJ9Up/qoAxJnVzZr+rhzvHSslJH8IPl4zr/OoM
 WIZl/Jj/o5p24Sy+HLtZVffQTBjvQXprV3kgWPLCeDC9yuCjuF99fjustehoTZ5g5enxdRNninGOM
 jxa8xNLIg==;
Received: from [31.185.128.125] (port=47168 helo=[192.168.0.6]) by
 server.dnsblock1.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128)
 (Exim 4.92) (envelope-from <in@bobbriscoe.net>) id 1jBigN-00025P-IE; Tue, 10
 Mar 2020 17:28:43 +0000
To: Donald Eastlake <d3e3e3@gmail.com>, tsvwg@ietf.org
References:
 <CAF4+nEGu9XEiXypPw0NK+f2N9QbBwyTJKXbViKWVScJhOW=vUA@mail.gmail.com>
 <CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com>
From: Bob Briscoe <in@bobbriscoe.net>
Cc: John Kaippallimalil <John.Kaippallimalil@huawei.com>
Message-ID: <56499dde-81f1-5bd7-fd7c-67a201376e6a@bobbriscoe.net>
Date: Tue, 10 Mar 2020 17:28:42 +0000
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101
 Thunderbird/60.6.1
MIME-Version: 1.0
In-Reply-To:
 <CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com>
Content-Type: multipart/alternative;
 boundary="------------26DA1A1E232224BCE092C062"
Content-Language: en-GB
X-AntiAbuse: This header was added to track abuse,
 please include it with any abuse report
X-AntiAbuse: Primary Hostname - server.dnsblock1.com
X-AntiAbuse: Original Domain - ietf.org
X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse: Sender Address Domain - bobbriscoe.net
X-Get-Message-Sender-Via: server.dnsblock1.com: authenticated_id:
 in@bobbriscoe.net
X-Authenticated-Sender: server.dnsblock1.com: in@bobbriscoe.net
Archived-At:
 <https://mailarchive.ietf.org/arch/msg/tsvwg/oKBtQupb1Mmn8-giX_ITXILun-4>
Subject: Re: [tsvwg] Comments on draft-ietf-tsvwg-ecn-encap-guidelines-13
X-BeenThere: tsvwg@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Transport Area Working Group <tsvwg.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tsvwg>,
 <mailto:tsvwg-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tsvwg/>
List-Post: <mailto:tsvwg@ietf.org>
List-Help: <mailto:tsvwg-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tsvwg>,
 <mailto:tsvwg-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Mar 2020 17:28:51 -0000

This is a multi-part message in MIME format.
--------------26DA1A1E232224BCE092C062
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

Donald,

Thank you for taking the time to review this (rather long) draft.
Apologies for not getting to your review until now.

On 06/02/2020 23:03, Donald Eastlake wrote:
> Hi,
>
> I'm not subscribed to the tsvwg mailing list but I have reviewed 
> draft-ietf-tsvwg-ecn-encap-guidelines-13 and though you might be 
> interested in my comments.
>
> Overall, this is a very clear and well-written draft. The comments 
> below are minor. Whether or not they are incorporated into the draft, 
> I hope that it can be advanced soon.
>
> Section 1. I suggest just deleting the one occurrence in the draft of 
> "[RFC1323]" and the corresponding reference section entry. It seems 
> unnecessary and just leads to a nits checker warning which will have 
> to be explained, etc.
>
> Section 1.1. Very minor but I believe the usual way, inside a draft, 
> to refer to the RFC which that draft might become is "[this document]" 
> (without the double quotes) rather than "[RFCXXXX]". Changing to the 
> more common notation would, I believe, enable the RFC Editor note to 
> be removed as "[this document]" is well understood by the RFC Editor.
>
> Section 2. The initial paragraph on implementation keywords should be 
> updated to the following as per RFC 8174:
>
>     The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
>     "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
>     document are to be interpreted as described in [RFC2119] [RFC8174]
>     when, and only when, they appear in all capitals, as shown here.
>
Done all the above
(BTW, I always baulk at having to cite RFC8174, when the following 12 
words succinctly state the sum total of its content.)

>
> Section 2. Suggest putting the Terminology entries in alphabetic order..
I haven't done this. They are more for reading through than for being 
looked up individually, most of them fall into logical little groups, 
and there are not so many that it's hard to find one.

>
> Section 4.2, page 18. "802.1p" has been merged into 802.1Q ages ago. 
> Values of the priority field are commonly referred to in IEEE 802.1 as 
> Priority Code Points (PCPs) and in any case this seems a bit 
> inconsistent to the way that the merger of 802.1ah into 802.1Q is 
> recognized in the draft. Perhaps the last sentence of Section 4.2 
> could be: "An operator can define certain [IEEE802.1Q] Priority Code 
> Points to indicate non-QCN frames and an ingress bridge is required to 
> map arriving not-QCN-capable IP packets to one of these code points."
OK. I've taken on board the spirit of your edit, but changed it slightly:

    An operator can define certain
    Priority Code Points (PCPs [IEEE802.1Q]; previously 802.1p) to
    indicate non-QCN frames and an ingress bridge is required to map
    arriving not-QCN-capable IP packets to one of these non-QCN PCPs.

This is then consistent with the other references to 802.1Q, which also 
give the number of the constituent part before it was wrapped up into 
the mega-standard. If you think this is clumsy, pls say. I did it this 
way, because many people know these 802.1 drafts much better by their 
old name (well, for 'many people' read 'me', or perhaps read it as 'old 
farts like me').

>
> Section 4.4, point 1, first starred subpoint, there is something odd 
> about "the packet MAY be forwarded, but it SHOULD be dropped".
Any better (I've added some of the context for the list)?:

           If the congestion marking is the
           most severe possible, the packet MUST be dropped.  However, if
           congestion can be marked with multiple levels of severity and
           the packet's marking is not the most severe, this requirement
           can be relaxed to: the packet SHOULD be dropped, but it MAY be
           forwarded.

>
> Section 7. It doesn't matter much but IANA would prefer that sections 
> saying there are no IANA actions be left in the final RFC (see Section 
> 9.1 of RFC 8126).
I'm learning something new every day.

>
> Section 9. Should "the document" in the first line of this section by 
> "this document"?
Yes. Done.
>
> Appendix A. I did not review this update history.
>
> Authors' Addresses: I don't think Pat Thaler can be listed as a front 
> page "author" in the RFC sense unless at least an email address is 
> listed for her. All authors should be pollable about IPR they know and 
> when the draft gets to the AUTH48 state before RFC publication, the 
> RFC editor must be able to contact all the authors. If no email 
> address is known, she should be moved to a "Contributors" section or 
> the like.
Yes. I discovered that (too late) last night, when the draft got 
rejected on this point!
I've added a Contributors section for her.

Thank you again.



Bob




-- 
________________________________________________________________
Bob Briscoe                               http://bobbriscoe.net/


--------------26DA1A1E232224BCE092C062
Content-Type: text/html; charset=utf-8
Content-Transfer-Encoding: 7bit

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
    Donald,<br>
    <br>
    Thank you for taking the time to review this (rather long) draft.<br>
    Apologies for not getting to your review until now.<br>
    <br>
    <div class="moz-cite-prefix">On 06/02/2020 23:03, Donald Eastlake
      wrote:<br>
    </div>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      <div dir="ltr">
        <div>
          <div dir="ltr" class="gmail_signature"
            data-smartmail="gmail_signature">Hi,<br>
          </div>
        </div>
        <div class="gmail_quote">
          <div dir="ltr">
            <div><br>
              I'm not subscribed to the tsvwg mailing list but I have
              reviewed draft-ietf-tsvwg-ecn-encap-guidelines-13 and
              though you might be interested in my comments.<br>
              <br>
              Overall, this is a very clear and well-written draft. The
              comments below are minor. Whether or not they are
              incorporated into the draft, I hope that it can be
              advanced soon.<br>
              <br>
              Section 1. I suggest just deleting the one occurrence in
              the draft of "[RFC1323]" and the corresponding reference
              section entry. It seems unnecessary and just leads to a
              nits checker warning which will have to be explained, etc.
              <div><br>
                Section 1.1. Very minor but I believe the usual way,
                inside a draft, to refer to the RFC which that draft
                might become is "[this document]" (without the double
                quotes) rather than "[RFCXXXX]". Changing to the more
                common notation would, I believe, enable the RFC Editor
                note to be removed as "[this document]" is well
                understood by the RFC Editor.
                <div><br>
                  Section 2. The initial paragraph on implementation
                  keywords should be updated to the following as per RFC
                  8174:<br>
                </div>
              </div>
            </div>
            <blockquote style="margin:0 0 0
              40px;border:none;padding:0px">
              <div>
                <div>
                  <div>The key words "MUST", "MUST NOT", "REQUIRED",
                    "SHALL", "SHALL NOT",</div>
                </div>
              </div>
              <div>
                <div>
                  <div>"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
                    "OPTIONAL" in this</div>
                </div>
              </div>
              <div>
                <div>
                  <div>document are to be interpreted as described in
                    [RFC2119] [RFC8174]</div>
                </div>
              </div>
              <div>
                <div>
                  <div>when, and only when, they appear in all capitals,
                    as shown here.</div>
                </div>
              </div>
            </blockquote>
          </div>
        </div>
      </div>
    </blockquote>
    Done all the above<br>
    (BTW, I always baulk at having to cite RFC8174, when the following
    12 words succinctly state the sum total of its content.)<br>
    <br>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <div dir="ltr">
        <div class="gmail_quote">
          <div dir="ltr">
            <div>
              <div>
                <div><br>
                  Section 2. Suggest putting the Terminology entries in
                  alphabetic order..<br>
                </div>
              </div>
            </div>
          </div>
        </div>
      </div>
    </blockquote>
    I haven't done this. They are more for reading through than for
    being looked up individually, most of them fall into logical little
    groups, and there are not so many that it's hard to find one.<br>
    <br>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <div dir="ltr">
        <div class="gmail_quote">
          <div dir="ltr">
            <div>
              <div>
                <div><br>
                  Section 4.2, page 18. "802.1p" has been merged into
                  802.1Q ages ago. Values of the priority field are
                  commonly referred to in IEEE 802.1 as Priority Code
                  Points (PCPs) and in any case this seems a bit
                  inconsistent to the way that the merger of 802.1ah
                  into 802.1Q is recognized in the draft. Perhaps the
                  last sentence of Section 4.2 could be: "An operator
                  can define certain [IEEE802.1Q] Priority Code Points
                  to indicate non-QCN frames and an ingress bridge is
                  required to map arriving not-QCN-capable IP packets to
                  one of these code points."</div>
              </div>
            </div>
          </div>
        </div>
      </div>
    </blockquote>
    OK. I've taken on board the spirit of your edit, but changed it
    slightly:<br>
    <pre>   An operator can define certain
   Priority Code Points (PCPs [IEEE802.1Q]; previously 802.1p) to
   indicate non-QCN frames and an ingress bridge is required to map
   arriving not-QCN-capable IP packets to one of these non-QCN PCPs.</pre>
    This is then consistent with the other references to 802.1Q, which
    also give the number of the constituent part before it was wrapped
    up into the mega-standard. If you think this is clumsy, pls say. I
    did it this way, because many people know these 802.1 drafts much
    better by their old name (well, for 'many people' read 'me', or
    perhaps read it as 'old farts like me').<br>
    <br>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <div dir="ltr">
        <div class="gmail_quote">
          <div dir="ltr">
            <div>
              <div>
                <div><br>
                </div>
                <div>Section 4.4, point 1, first starred subpoint, there
                  is something odd about "the packet MAY be forwarded,
                  but it SHOULD be dropped". <br>
                </div>
              </div>
            </div>
          </div>
        </div>
      </div>
    </blockquote>
    Any better (I've added some of the context for the list)?:<br>
    <pre>          If the congestion marking is the
          most severe possible, the packet MUST be dropped.  However, if
          congestion can be marked with multiple levels of severity and
          the packet's marking is not the most severe, this requirement
          can be relaxed to: the packet SHOULD be dropped, but it MAY be
          forwarded.</pre>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <div dir="ltr">
        <div class="gmail_quote">
          <div dir="ltr">
            <div>
              <div><br>
              </div>
              <div>Section 7. It doesn't matter much but IANA would
                prefer that sections saying there are no IANA actions be
                left in the final RFC (see Section 9.1 of RFC 8126).</div>
            </div>
          </div>
        </div>
      </div>
    </blockquote>
    I'm learning something new every day.<br>
    <br>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <div dir="ltr">
        <div class="gmail_quote">
          <div dir="ltr">
            <div>
              <div><br>
              </div>
              <div>Section 9. Should "the document" in the first line of
                this section by "this document"?</div>
            </div>
          </div>
        </div>
      </div>
    </blockquote>
    Yes. Done.<br>
    <blockquote type="cite"
cite="mid:CAF4+nEEB2-pz4ugW-m1-3gq9KH-fyt93sLZ9WFh4BkJqQPX7PA@mail.gmail.com">
      <div dir="ltr">
        <div class="gmail_quote">
          <div dir="ltr">
            <div>
              <div><br>
              </div>
              <div>Appendix A. I did not review this update history.</div>
              <div><br>
              </div>
              <div>Authors' Addresses: I don't think Pat Thaler can be
                listed as a front page "author" in the RFC sense unless
                at least an email address is listed for her. All authors
                should be pollable about IPR they know and when the
                draft gets to the AUTH48 state before RFC publication,
                the RFC editor must be able to contact all the authors.
                If no email address is known, she should be moved to a
                "Contributors" section or the like.</div>
            </div>
          </div>
        </div>
      </div>
    </blockquote>
    Yes. I discovered that (too late) last night, when the draft got
    rejected on this point!<br>
    I've added a Contributors section for her.<br>
    <br>
    Thank you again.<br>
    <br>
    <br>
    <br>
    Bob<br>
    <br>
    <br>
    <br>
    <br>
    <pre class="moz-signature" cols="72">-- 
________________________________________________________________
Bob Briscoe                               <a class="moz-txt-link-freetext" href="http://bobbriscoe.net/">http://bobbriscoe.net/</a></pre>
  </body>
</html>

--------------26DA1A1E232224BCE092C062--

