netmod-wg / yang-next

Feature requests for future versions of YANG
6 stars 0 forks source link

Revise Module Update Rules #136

Open abierman opened 2 weeks ago

abierman commented 2 weeks ago

module update rules

Dreaded "Section 11" had caused more trouble than any other section.

NBC Change

New Identifier Not Mandatory

WG list discussion has resulted in the following change text change in this section

OLD

   Otherwise, if the semantics of any previous definition are changed
   (i.e., if a non-editorial change is made to any definition other than
   those specifically allowed above), then this MUST be achieved by a
   new definition with a new identifier.

   In statements that have any data definition statements as
   substatements, those data definition substatements MUST NOT be
   reordered.  If new data definition statements are added, they can be
   added anywhere in the sequence of existing substatements.

NEW

   Otherwise, if the semantics of any previous definition are changed
   (i.e., if a non-editorial change is made to any definition other than
   those specifically allowed above), then this SHOULD be achieved by a
   new definition with a new identifier.

   In statements that have any data definition statements as
   substatements, those data definition substatements SHOULD NOT be
   reordered.  If new data definition statements are added, they can be
   added anywhere in the sequence of existing substatements.

Other refinements may be identified during development

Must Do: complexity: medium, bc: low, importance: high