[netmod] FW: New Version Notification for draft-ma-netmod-immutable-flag-07.txt

["maqiufang (A)" <[e-mail]>]

Hi, all

This version reflects the input we've received from the mailing list.



Thank you everyone(Jan, Rob, Kent, Jürgen, Andy, Frank et al.) for your great comments and suggestions!

Please see if the following updates are good for you:

   *  Use a Boolean type for the immutable value in YANG extension and

      metadata annotation

   *  Define a "with-immutable" parameter and state that immutable

      metadata annotation is not included in a response unless a client

      explicitly requests them with a "with-immutable" parameter

   *  reword the abstract and related introduction section to highlight

      immutable flag is descriptive

   *  Add a new section to define immutability of interior nodes, and

      merge with "Inheritance of Immutable configuration" section

   *  Add a new section to define what the immutable flag means for each

      YANG data node

   *  Define the "immutable flag" term.

   *  Add an item in the open issues tracking: Should the "immutable"

      metadata annotation also be returned for nodes described as

      immutable in the YANG schema so that there is a single source of

      truth.



Thanks a lot.



Best Regards,

Qiufang



-----Original Message-----
From: [e-mail] [mailto:[e-mail]]
Sent: Thursday, May 25, 2023 4:52 PM
To: Balazs Lengyel <[e-mail]>; Hongwei Li <[e-mail]>; Qin Wu <[e-mail]>; Qin Wu <[e-mail]>; maqiufang (A) <[e-mail]>
Subject: New Version Notification for draft-ma-netmod-immutable-flag-07.txt





A new version of I-D, draft-ma-netmod-immutable-flag-07.txt

has been successfully submitted by Qiufang Ma and posted to the IETF repository.



Name:                  draft-ma-netmod-immutable-flag

Revision:              07

Title:                      YANG Extension and Metadata Annotation for Immutable Flag

Document date:               2023-05-25

Group:                  Individual Submission

Pages:                   24

URL:            https://www.ietf.org/archive/id/draft-ma-netmod-immutable-flag-07.txt

Status:         https://datatracker.ietf.org/doc/draft-ma-netmod-immutable-flag/

Htmlized:       https://datatracker.ietf.org/doc/html/draft-ma-netmod-immutable-flag

Diff:           https://author-tools.ietf.org/iddiff?url2=draft-ma-netmod-immutable-flag-07



Abstract:

   This document defines a way to formally document existing behavior,

   implemented by servers in production, on the immutability of some

   configuration nodes, using a YANG "extension" and a YANG metadata

   annotation, both called "immutable", which are collectively used to

   flag which data nodes are immutable.



   Clients may use "immutable" statements in the YANG, and annotations

   provided by the server, to know beforehand when certain otherwise

   valid configuration requests will cause the server to return an

   error.



   The immutable flag is descriptive, documenting existing behavior, not

   proscriptive, dictating server behavior.









The IETF Secretariat