Re: [TICTOC] Benjamin Kaduk's Discuss on draft-ietf-tictoc-1588v2-yang-10: (with DISCUSS and COMMENT)

[Benjamin Kaduk <[e-mail]>]

On Mon, Oct 15, 2018 at 04:21:48PM +0000, Jiangyuanlong wrote:
> > 
> > Indeed, this topic is quite related to Ben's point about document access.
> > Though I think generally we still want our documents to be able to stand
> > alone in some sense, so there's a balance to find.
> > 
> [YJ] I agree with you that there is a balance to find. Actually, there have been quite a few discussions happened in the mailing list of TICTOC WG regarding whether we add more details to the terms in the document, the IEEE 1588 participants strongly advised we refer to the IEEE 1588 terminologies and keep the texts as simple as possible in the draft. Since the targeted readers are mainly implementers and operators of IEEE 1588 community, and the YANG module will be transferred to the IEEE 1588 WG as in our plan, I hope the balance will be somewhat more tilted towards them;) 

Ah, thanks for the extra background from the WG.  I am interested to see
how Ben's Discuss gets resolved, which may end up doing enough for me to be
able to resolve mine as a side effect.

> > > > ----------------------------------------------------------------------
> > > > COMMENT:
> > > > ----------------------------------------------------------------------
> > > >
> > > > Section 1
> > > >
> > > >    o  When the IEEE 1588 standard is revised (e.g. the IEEE 1588
> > > >    revision in progress at the time of writing this document), it will
> > > >    add some new optional features to its data sets.  The YANG module
> > > >    of this document MAY be revised and extended to support these new
> > > >    features. Moreover, the YANG "revision" SHOULD be used to indicate
> > > >    changes to the YANG module under such a circumstance.
> > > >
> > > > It's not clear that a 2119 SHOULD is best here; I would have expected
> > > > either an 8174 "should" or a 2119 "MUST".
> > > >
> > > [YJ] Are you suggesting to use "must" or "MUST"? Otherwise, I think
> > "should" is similar to "SHOULD".
> > 
> > I was suggesting "MUST".
> > 
> [YJ] How about change "MAY" to "can", and "SHOULD" to "MUST" in the above bullet? Hopefully the new changes indicate a stronger expectation.

They do, thanks!

-Benjamin