Benoit Claise <bcla...@cisco.com> wrote:
> Hi Martin,
> > Benoit Claise <bcla...@cisco.com> wrote:
> >> Hi Martin,
> >>
> >> Removed some extra ones on which we agree.
> >> See in line.
> >>>>>> - Terminology:
> >>>>>>     The following terms are defined in [RFC6241
> >>>>>>     <https://tools.ietf.org/html/rfc6241>]:
> >>>>>>
> >>>>>>       ...
> >>>>>>
> >>>>>>       o  configuration datastore: a configuration datastore is an
> >>>>>>          instantiated data tree with configuration data
> >>>>>>
> >>>>>>       o  datastore: an instantiated data tree
> >>>>>>
> >>>>>> RFC6241 has different definition for "configuration datastore" and
> >>>>>> "datastore".
> >>>>>> I would just provide the pointer to the RFC 6241 definitions.
> >>>>>> If you intend to provide an adapted definition for the YANG mappings,
> >>>>>> then you should say so.
> >>>>> How about:
> >>>>>
> >>>>> OLD:
> >>>>>
> >>>>>       o  configuration datastore: a configuration datastore is an
> >>>>>          instantiated data tree with configuration data
> >>>>>
> >>>>>       o  datastore: an instantiated data tree
> >>>>>
> >>>>> NEW:
> >>>>>
> >>>>>       o configuration datastore: When modelled with YANG, a 
> >>>>> configuration
> >>>>>          datastore is an instantiated data tree with configuration data
> >>>>>
> >>>>>       o  datastore: When modelled with YANG, an instantiated data tree
> >>>>>
> >>>> This issue is with "The following terms are defined in [RFC6241]", but
> >>>> you re-define those terms.
> > I don't think it is correct to say that we "re-define" these terms.
> > It sounds like we give the terms a different meaning.
> Playing with words? :-)
> >   I agree that
> > the OLD text gave that impression, but I think the NEW proposed text
> > fixes this.
> This does not work.
> 
> Reading the terminology ...
> 
>        The following terms are defined in [RFC6241
>        <https://tools.ietf.org/html/rfc6241>]:
> 
>      o  configuration datastore: ...
> 
>      o  datastore: ...
> 
> ... I will not even bother reading the definitions, because I know
> them from 6241.
> Doing this, I will not spot the subtle "different meaning" you
> inserted in the definitions.

Ok, how about moving the specialized-meaning-text to its own paragraph:


  The following terms are defined in [RFC6241]:

   o  configuration data

   o  configuration datastore

   o  datastore

   o  running configuration datastore

   o  state data

   When modelled with YANG, a datastore is realized as an instantiated
   data tree.

   When modelled with YANG, a configuration datastore is realized as an
   instantiated data tree with configuration data.



/martin

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

Reply via email to