Skip to main content

Early Review of draft-ietf-teas-ietf-network-slice-nbi-yang-16
review-ietf-teas-ietf-network-slice-nbi-yang-16-yangdoctors-early-lhotka-2024-12-18-00

Request Review of draft-ietf-teas-ietf-network-slice-nbi-yang
Requested revision No specific revision (document currently at 24)
Type Early Review
Team YANG Doctors (yangdoctors)
Deadline 2024-12-20
Requested 2024-10-29
Requested by Jim Guichard
Authors Bo Wu , Dhruv Dhody , Reza Rokui , Tarek Saad , John Mullooly
I-D last updated 2025-04-30 (Latest revision 2025-04-30)
Completed reviews Rtgdir Early review of -12 by Alvaro Retana (diff)
Yangdoctors Early review of -03 by Ladislav Lhotka (diff)
Yangdoctors Early review of -16 by Ladislav Lhotka (diff)
Secdir IETF Last Call review of -17 by Mike Ounsworth (diff)
Rtgdir IETF Last Call review of -17 by Susan Hares (diff)
Opsdir IETF Last Call review of -18 by Per Andersson (diff)
Tsvart IETF Last Call review of -17 by Kyle Rose (diff)
Genart IETF Last Call review of -17 by Ines Robles (diff)
Opsdir Telechat review of -22 by Per Andersson (diff)
Assignment Reviewer Ladislav Lhotka
State Completed
Request Early review on draft-ietf-teas-ietf-network-slice-nbi-yang by YANG Doctors Assigned
Posted at https://mailarchive.ietf.org/arch/msg/yang-doctors/5B429OrbAR2xrjv-r2ONgPBmBHU
Reviewed revision 16 (document currently at 24)
Result Ready w/issues
Completed 2024-12-18
review-ietf-teas-ietf-network-slice-nbi-yang-16-yangdoctors-early-lhotka-2024-12-18-00
I also reviewed previous version -03 of this document. All my objections and
recommendations from that review have been taken into consideration, except for
this one:

In JSON representation of leafref instance values, the module prefix "ietf-nss"
cannot be used as a namespace identifier (because the prefix isn't declared in
JSON). In the namespace-qualified form, the full module name has to be used.
However, no namespace is needed here because the referred identities are
defined in the same module as the leafref data nodes. See section 6.8 in RFC
7951. Therefore, it is necessary to either replace all 75 occurences of the
"ietf-nss" prefix in Appendix B with "ietf-network-slice-service", or remove
the prefixes altogether.

**** Nits

- Names of several lists are somewhat confusing. For example, list "tag-type"
has two children: "tag-type" (key) and "value". It would IMO be better to call
the outer list e.g. "tag-type-value". - Upcoming RFCs with placeholder numbers
BBBB, CCCC and DDDD that are used in reference statements should also appear in
sec. 11.1 (Normative References).