Hi,

https://tools.ietf.org/html/draft-bjorklund-netmod-yang-tree-diagrams-00


The introduction in this draft does not really reflect the goals that need
to
be addressed. Perhaps:

sec 1, para 1:
OLD:

   This document
   provides the syntax used in YANG Tree Diagrams.  It is expected that
   this document will be updated or replaced as changes to the YANG
   language, see [RFC7950 <https://tools.ietf.org/html/rfc7950>], necessitate.


NEW:

   This document provides the syntax used in YANG Tree Diagrams

   for version 1.1 of the YANG data modeling language [RFC7950
<https://tools.ietf.org/html/rfc7950>].

   It is expected that this document will be updated or replaced

   for future versions of YANG. It should be possible for

   multiple independent tools to generate the same YANG tree diagrams,

   using this specification.


Sec. 2:

The vertical bar (|) and indentation is not defined.

The tab alignment is not defined

The general recursive algorithm is not defined.

The mandatory vs. optional parts of the diagram are not defined.

(e.g., groupings, notifications, rpcs)

Examples of all field types should be provided (e.g if-features)

An ABNF for the grammar should be provided.



Andy
_______________________________________________
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod

Reply via email to