Skip to main content

Early Review of draft-ietf-teas-yang-l3-te-topo-16
review-ietf-teas-yang-l3-te-topo-16-yangdoctors-early-andersson-2024-05-06-00

Request Review of draft-ietf-teas-yang-l3-te-topo-16
Requested revision 16 (document currently at 16)
Type Early Review
Team YANG Doctors (yangdoctors)
Deadline 2024-05-07
Requested 2024-04-16
Requested by Lou Berger
Authors Xufeng Liu , Igor Bryskin , Vishnu Pavan Beeram , Tarek Saad , Himanshu C. Shah , Oscar Gonzalez de Dios
I-D last updated 2024-05-06
Completed reviews Rtgdir Early review of -16 by Shuping Peng
Yangdoctors Early review of -16 by Per Andersson
Yangdoctors Early review of -04 by Mahesh Jethanandani (diff)
Comments
2nd early review, together with WG LC, see https://mailarchive.ietf.org/arch/msg/teas/uKIxNQBTNkUMxmelf7Pj5r_cT14/
Assignment Reviewer Per Andersson
State Completed
Request Early review on draft-ietf-teas-yang-l3-te-topo by YANG Doctors Assigned
Posted at https://mailarchive.ietf.org/arch/msg/yang-doctors/EHdViBZhDht1at3KGIDiwj58jig
Reviewed revision 16
Result Ready w/issues
Completed 2024-05-06
review-ietf-teas-yang-l3-te-topo-16-yangdoctors-early-andersson-2024-05-06-00
Hi!

This is my YANG-Doctor Last-Call review of
draft-ietf-teas-yang-l3-te-topo-16. This draft contains four modules
which seem to be in good shape but still have a few issues and nits.


Summary:

This document defines a YANG data model for layer 3 traffic engineering
topologies.


Comments:

o The YANG tree diagram listing is in better shape since the last
  review. However, there is still a lot of repetition and long YANG tree
  diagrams in Sections 4.2.2, 4.2.3, 4.2.4, 4.2.5, 4.2.6, 4.2.7, and
  4.2.11. Suggest to summarize the additions and further explain the
  augments. For instance explain the different augments once, in a cut
  out, and the add where it is augmented. The sections would also
  benefit from some pruning and more explanation of the presented YANG
  tree diagram.

o Checking YANG models

  Using pyang --ietf --lint yields several of the following errors

      ietf-te-topology-packet@2024-03-02.yang:416: error: grouping
      "te-packet-path-bandwidth" not found in module
      "ietf-te-packet-types"

      ietf-te-topology-packet-state@2024-03-02.yang:345: error: grouping
      "te-packet-path-bandwidth" not found in module
      "ietf-te-packet-types"

  It was not possible to see what grouping this might have been in
  ietf-te-packet-types. There is no "te-packet-path-bandwidth" grouping
  in any revision of ietf-te-packet-types.yang.

  Using yanglint yields no additional errors or warnings.

o Checking example instance data

  Using yanglint the following error is raised when validating the
  example data in Appendix B

      libyang err : Grouping "te-packet-types:te-packet-link-bandwidth"
      referenced by a uses statement not found. (Path
      "/ietf-te-topology-packet:{augment='/nw:networks/nw:network/\
      nw:node/tet:te/tet:te-node-attributes/\
      tet:connectivity-matrices/tet:path-constraints/tet:te-bandwidth/\
      tet:technology'}/ietf-te-topology-packet:packet/\
      {uses='te-packet-types:te-packet-link-bandwidth'}".)


Nits:

o The previous review asked for consistency regarding "description" and
  "presence" statements. There are still some inconsistensies, e.g.
  variating starting on the same or following line after the keyword.
  Please ensure that the style is consistent throughout the models.
  Suggest that all "description" and "presence" strings start on the
  line after the keyword because that style is mostly used throughout
  the models.

o The when and augment expressions' arguments are sometimes misaligned
  if they line wrap and are concatenated. Suggest aligning the
  subsequent concatenated strings with the first one.

o Extra space before "supported." in the module description for
  ietf-te-topology-packet-state.yang.

o In Section 4.2, the sentence needs to add article (the) before base:

      This is an augmentation to base TE topology model.


--
Per