[RTG-DIR] RtgDir review: draft-ietf-pce-pcep-service-aware-11

<chopps@chopps.org> Sun, 07 August 2016 15:24 UTC

Return-Path: <chopps@chopps.org>
X-Original-To: rtg-dir@ietfa.amsl.com
Delivered-To: rtg-dir@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9FFC812D195; Sun, 7 Aug 2016 08:24:55 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.147
X-Spam-Level:
X-Spam-Status: No, score=-3.147 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RP_MATCHES_RCVD=-1.247] autolearn=ham autolearn_force=no
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 V1twcmMq0HMK; Sun, 7 Aug 2016 08:24:54 -0700 (PDT)
Received: from smtp.chopps.org (smtp.chopps.org [54.88.81.56]) by ietfa.amsl.com (Postfix) with ESMTP id DD07B12B03A; Sun, 7 Aug 2016 08:24:53 -0700 (PDT)
Received: from tops.chopps.org (unknown [166.170.34.46]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by smtp.chopps.org (Postfix) with ESMTPSA id C7E7A61FBF; Sun, 7 Aug 2016 15:24:52 +0000 (UTC)
User-agent: mu4e 0.9.16; emacs 24.5.1
From: chopps@chopps.org
To: rtg-ads@ietf.org
Date: Sun, 07 Aug 2016 11:24:50 -0400
Message-ID: <87bn1461q5.fsf@tops.chopps.org>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-="; micalg="pgp-sha512"; protocol="application/pgp-signature"
Archived-At: <https://mailarchive.ietf.org/arch/msg/rtg-dir/ODUXWEclVqt4U04LZslFrsRel4A>
Cc: rtg-dir@ietf.org, pce@ietf.org, draft-ietf-pce-pcep-service-aware-all@ietf.org
Subject: [RTG-DIR] RtgDir review: draft-ietf-pce-pcep-service-aware-11
X-BeenThere: rtg-dir@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Routing Area Directorate <rtg-dir.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rtg-dir>, <mailto:rtg-dir-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rtg-dir/>
List-Post: <mailto:rtg-dir@ietf.org>
List-Help: <mailto:rtg-dir-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rtg-dir>, <mailto:rtg-dir-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 07 Aug 2016 15:24:55 -0000

Hello,

I have been selected as the Routing Directorate reviewer for this draft.
The Routing Directorate seeks to review all routing or routing-related
drafts as they pass through IETF last call and IESG review, and
sometimes on special request. The purpose of the review is to provide
assistance to the Routing ADs. For more information about the Routing
Directorate, please see
​http://trac.tools.ietf.org/area/rtg/trac/wiki/RtgDir

Although these comments are primarily for the use of the Routing ADs, it
would be helpful if you could consider them along with any other IETF
Last Call comments that you receive, and strive to resolve them through
discussion or by updating the draft.

Document: draft-ietf-pce-pcep-service-aware-11
Reviewer: Christian Hopps
Review Date: August 7th, 2016
IETF LC End Date: Unknown
Intended Status: Standards Track

Summary:
========

    This document is basically ready for publication, but has nits that
    should be considered prior to publication.

Comments:
=========

    This document is clearly written and easy to understand.

Major Issues:
=============

    No major issues found.


Minor Issues:
=============

    - [4.1.5.1] Indicates inserting second METRIC object is optional ("may"),
      but doesn't say MUST or MAY for the first METRIC object. The implication
      is that the first METRIC object is required in the reply, if this isn't
      the case then a MAY/SHOULD would be useful here as well.

Nits:
=====

    - [4.1.5.1] uppercase "may" to MAY.

    - [4.2.1] parenthetical reference uses ``"Utilized Bandwidth"'' to refer to
      the IS-IS and OSPF values which are actualy defined in their respective
      documents using the text: "Unidirectional Utilized Bandwidth". I suggest
      updating this to match the referenced documents (i.e., add
      "Unidirectional").

    - [4.2.1] It's clear to me that the first paragraph is defining what LBU is;
      however, it never actually says this explicitly incase you wanted to.

    - [4.3] I found the formatting a bit odd with the "Objective Function Code:"
      the "Name:" and "Description:" being the final lines in the section
      defining them, but it's also hard to misinterpret the text when you
      actually read it so I don't know if any changes are needed.

    - [4.3 last paragraph] an unnamed procedure is referred to in RFC5541 here,
      I believe its use is more thoroughly described earlier in the document
      under "[4.2.3.1] Elements of Procedure", if so perhaps the reference
      should be to the text earlier in this document?

    - [6.1, 6.2] It's interesting that this text is actually replacing the
      message definition from the original specification. I understand it's
      trying to show where the new <bu-list> fits in, but it also is sort of
      redefining the actual makup of the entire message format. Using this
      method of description, each future extension to a message format must comb
      through any and all previous extensions, and also incorporate their
      changes as well; however, as this document isn't actually replacing
      RFC5541 (and neither would other extensions), or the STATEFUL-PCE
      document, so there's no document pointer trail to follow to do this --
      it's messy. A simple way to avoid this would be to present the change to
      the message definition using a diff like format indicating where the new
      <bu-list> fits into the already defined format and leave the overall
      definition of the message format in RFC5541.