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

Hi Quifang,

The latest update looks very good to me - IMO, ready for adoption.

Jan, Jurgen, Andy, Rob - can you confirm that your concerns have been addressed?

Thanks,
Kent

> On May 25, 2023, at 8:16 AM, maqiufang (A) <maqiufang1=40huawei.com@dmarc.ietf.org> wrote:
> 
> 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: internet-drafts@ietf.org <mailto:internet-drafts@ietf.org> [mailto:internet-drafts@ietf.org] 
> Sent: Thursday, May 25, 2023 4:52 PM
> To: Balazs Lengyel <balazs.lengyel@ericsson.com <mailto:balazs.lengyel@ericsson.com>>; Hongwei Li <flycoolman@gmail.com <mailto:flycoolman@gmail.com>>; Qin Wu <bill.wu@huawei.com <mailto:bill.wu@huawei.com>>; Qin Wu <bill.wu@huawei.com <mailto:bill.wu@huawei.com>>; maqiufang (A) <maqiufang1@huawei.com <mailto:maqiufang1@huawei.com>>
> 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
>  
>  
>  
> _______________________________________________
> netmod mailing list
> netmod@ietf.org <mailto:netmod@ietf.org>
> https://www.ietf.org/mailman/listinfo/netmod