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 _______________________________________________ TICTOC mailing list [email protected] https://www.ietf.org/mailman/listinfo/tictoc
