Hello Zahed, 
Please see answers below as BALAZS2.
Regards Balazs

-----Original Message-----
From: Zaheduzzaman Sarker <[email protected]> 
Sent: 2021. október 6., szerda 16:00
To: Balázs Lengyel <[email protected]>; The IESG <[email protected]>
Cc: [email protected]; 
[email protected]; [email protected]
Subject: Re: [netmod] Zaheduzzaman Sarker's No Objection on 
draft-ietf-netmod-yang-instance-file-format-20: (with COMMENT)



On 2021-10-06, 10:53, "Balázs Lengyel" <[email protected]> wrote:

    Hello Zaheduzzaman,
    Thank you for the review. 
    See detailed replies as "BALAZS:" below.
    Regards Balazs

    -----Original Message-----
    From: netmod <[email protected]> On Behalf Of Zaheduzzaman Sarker via
    Datatracker
    Sent: 2021. október 6., szerda 8:02
    To: The IESG <[email protected]>
    Cc: [email protected];
    [email protected]; [email protected]
    Subject: [netmod] Zaheduzzaman Sarker's No Objection on
    draft-ietf-netmod-yang-instance-file-format-20: (with COMMENT)

    Zaheduzzaman Sarker has entered the following ballot position for
    draft-ietf-netmod-yang-instance-file-format-20: No Objection

    When responding, please keep the subject line intact and reply to all email
    addresses included in the To and CC lines. (Feel free to cut this
    introductory paragraph, however.)


    Please refer to https://www.ietf.org/blog/handling-iesg-ballot-positions/
    for more information about how to handle DISCUSS and COMMENT positions.


    The document, along with other ballot positions, can be found here:
    https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-instance-file-format
    /



    ----------------------------------------------------------------------
    COMMENT:
    ----------------------------------------------------------------------

    Thanks for the efforts on this document.

    I have following comments, by addressing them I believe will improve the
    document quality

    - Section 2.1 : Should it not say if the "content-schema" node exists then
    one of the methods MUST be used? as I see the specification of content
    schema is a SHOULD, hence may not be included for whatever reason.
    BALAZS: In accordance with your comment the SHOULD will be changed to MUST.
    However, that still allows " External Method: Do not include the
    "content-schema" node;"
    People stated that when instance files are used repeatedly (a new file
    generated every few seconds) in a closed, well defined environment,  the
    content-schema may already be known. In this case it is not necessary to
    include it in the file.

I don't think we are on the same page here. I am basically saying in the 
context of this specification's section 2, the addition of content-schema is a 
SHOULD, hence one implementation can actually skip it. But then in 2.1, as the 
text describes the assumption seems to be the content-schema is always present 
(like a MUST). I am not asking to change the SHOULD to MUST in section 2, but 
to acknowledge the fact that section 2.1 is only applicable when there is 
"content-schema".
BALAZS2:  I see your point. I am trying to find the correct 
wording/documentation for it.
 Today Section 2.1 in -20 includes:
One of the following methods MUST be used:
     Inline method: ...
      Simplified-Inline method: ....
      URI method: ...

      External Method: Do not include the "content-schema" node; the
      user needs to obtain the information through external documents.

My idea was that the External method indicates that the content-schema might 
NOT be present in the instance-date-set.

If you think that's not clear, I could reword it to: 


  To properly understand and use an instance data set, the user needs
   to know the content-schema.  The content schema can be either 
  specified in external documents or within the instance data set. 
  In the latter case one of the following methods MUST be used:

      Inline method: Include the needed information as part of the
      instance data set.

      Simplified-Inline method: Include the needed information as part
      of the instance data set; short specification, only the module
      name and revision-date is used.

      URI method: Include a URI that references another YANG instance
      data file.  This instance data file will use the same content-
      schema as the referenced YANG instance data file.  (if you don't
      want to repeat the info again and again)

Please decide which is better!
-----------------------------------------------------------------------------------------------

    - Section 4 : it says

        Instance data files may contain sensitive data.

      OK, but what should be taken into consideration when putting the sensitive
      data in the data file. It feels like there should be more information
      provided to the user of the specification for actually materialize the
      statement made here.
    BALAZS: Instance data files may be used in many different use-cases. 
    Whether the data within is sensitive is completely dependent on the content
    schema applicable to the use-case.
    The draft contains:
    " The security sensitivity of the instance data in the content part is
       completely dependent on the content schema."
    Any suggestions about what else we could say?

In that case, if you think there is enough explanations, I will suggest to 
simply drop then one line (--Instance data files may contain sensitive data.) 
or make the one line part of the text you are referring to.
BALAZS2: OK, I will merge it into the paragraph referenced.

BR

Zahed


Attachment: smime.p7s
Description: S/MIME cryptographic signature

_______________________________________________
netmod mailing list
[email protected]
https://www.ietf.org/mailman/listinfo/netmod

Reply via email to