[Lsr] AD review of draft-ietf-lsr-yang-isis-reverse-metric-03

[John Scudder <[e-mail]>]

Dear Chris,

Here’s my review of this document. I only have a few nits, that should be easily addressed.

I’ve supplied my comments in the form of an edited copy of the draft. You can use your favorite diff tool to review them; I’ve attached a PDF of the rfcdiff output for your convenience if you’d like to use it. I’ve also pasted a traditional diff below in case you want to use it for in-line reply. I’d appreciate feedback regarding whether you found this a useful way to receive my comments as compared to a more traditional numbered list of comments with selective quotation from the draft.

Thanks,

—John

*** draft-ietf-lsr-yang-isis-reverse-metric-03.txt	2021-09-30 16:17:59.000000000 -0400
--- draft-ietf-lsr-yang-isis-reverse-metric-03-jgs-markup.txt	2021-09-30 16:29:43.000000000 -0400
***************
*** 17,22 ****
--- 17,30 ----
     extension to the the intermediate system to intermediate system
     routeing protocol.
  
+ While of course I have to concede that the formal name of the protocol
+ is as written, weird lower-case, quirky spelling, and all, it still
+ reads funny to me. I note that other IS-IS RFCs don't use this
+ convention, for example RFC 8500 uses "IS-IS" as the name of the
+ protocol in its own abstract. Do as you prefer, but if you keep the 
+ existing text, could you please at least add "(IS-IS)" at the end?
+ Thanks.
+ 
  Status of This Memo
  
     This Internet-Draft is submitted in full conformance with the
***************
*** 258,263 ****
--- 266,279 ----
                 neighbor to increment the overall metric up to 2^24-1 rather
                 than the lesser maximum of 2^24-2, and if done will cause
                 traffic to stop using rather than avoid using the interface.";
+                
+ "And if done" is ambiguous and not quite accurate (just setting the bit
+ doesn't force the metric to 2^24-1, it only allows the sum to go that
+ high, right?). Consider something like the following? "... rather than
+ the lesser maximum of 2^24-2. If the metric becomes 2^24-1, this will
+ cause traffic to stop using the interface altogether, rather than
+ tending to avoid it as it would with a metric of 2^24-2."
+ 
             reference "RFC8500, Section 2";
           }
         }
***************
*** 430,436 ****
  
     The YANG module defined in this document can enable, disable and
     modify the behavior of metrics used by routing.  For the security
!    implications regarding these types of changes consult the [RFC8500]
     which defines the functionality.
  
     There are a number of data nodes defined in this YANG module that are
--- 446,452 ----
  
     The YANG module defined in this document can enable, disable and
     modify the behavior of metrics used by routing.  For the security
!    implications regarding these types of changes consult [RFC8500]
     which defines the functionality.
  
     There are a number of data nodes defined in this YANG module that are
***************
*** 492,498 ****
     nodes and their sensitivity/vulnerability:
  
     All nodes are under the following subtree, so that prefix will be
!    assume for each node description.
  
  
  
--- 508,514 ----
     nodes and their sensitivity/vulnerability:
  
     All nodes are under the following subtree, so that prefix will be
!    assumed for each node description.
  
  
  
***************
*** 528,534 ****
  
     [ISO10589] International Organization for Standardization,
                "Intermediate system to intermediate system intra-domain-
!               routing routine information exchange protocol for use in
                conjunction with the protocol for providing the
                connectionless-mode Network Service (ISO 8473)",
                ISO Standard 10589, 1992.
--- 544,550 ----
  
     [ISO10589] International Organization for Standardization,
                "Intermediate system to intermediate system intra-domain-
!               routeing routine information exchange protocol for use in
                conjunction with the protocol for providing the
                connectionless-mode Network Service (ISO 8473)",
                ISO Standard 10589, 1992.