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

[Jiangyuanlong <[e-mail]>]

Ben, 

Thanks much for the review and the opinions, please see my replies prefixed with [JY].

Regards,
Yuanlong

> -----Original Message-----
> From: Ben Campbell [mailto:[e-mail]]
> Sent: Thursday, October 11, 2018 4:44 AM
> To: The IESG
> Cc: [e-mail]; Karen O'Donoghue;
> [e-mail]; [e-mail]; [e-mail]
> Subject: Ben Campbell's Discuss on draft-ietf-tictoc-1588v2-yang-10: (with
> DISCUSS and COMMENT)
> 
> Ben Campbell has entered the following ballot position for
> draft-ietf-tictoc-1588v2-yang-10: Discuss
> 
> 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/iesg/statement/discuss-criteria.html
> for more information about IESG DISCUSS and COMMENT positions.
> 
> 
> The document, along with other ballot positions, can be found here:
> https://datatracker.ietf.org/doc/draft-ietf-tictoc-1588v2-yang/
> 
> 
> 
> ----------------------------------------------------------------------
> DISCUSS:
> ----------------------------------------------------------------------
> 
> This is a process discuss, or maybe a discuss discuss. I expect to clear it
> once a discussion has occurred regardless of the outcome, but I want to
> make
> sure the discussion happens.
> 
> §2 contains the following paragraph:
> 
> "  The readers are assumed to be familiar with IEEE 1588-2008. As all
>    PTP terminologies and PTP data set attributes are described in
>    details in IEEE 1588-2008 [IEEE1588], this document only outlines
>    each of them in the YANG module."
> 
> If I understand correctly, IEEE 1588-2008 is not available without payment. If
> so, then I don't see how we can assume that reviewers of this draft are
> actually familiar with IEEE 1588-2008. It seems like that makes it hard for the
> draft to get sufficient review to be considered a standards-track IETF
> consensus document. I recognize that we do not have a policy against
> normative
> references to paywalled sources, but I read the disclaimer to make the IEEE
> document more foundational than just any normative reference.
> 
>
[YJ] I realized that most IEEE standards needs to be bought or accessed via subscription (such as 802.1, 802.3 and etc). Most SDOs will keep their documents in development only internally available. In such a case, one typical cooperation mechanism between SDOs is via official liaisons, for example, a document from a SDO (whether it is published or not) can be liaised to another SDO for reviews. Maybe we can establish such a relationship at an early stage next time so that IETF reviews can be more smooth.


> ----------------------------------------------------------------------
> COMMENT:
> ----------------------------------------------------------------------
> 
> §1, 2nd bullet: "The YANG module of this document MAY be revised..."
> That seems more a statement of fact than permission.
> 
[YJ] agreed, to align with these bullets, "MAY" will change to "may", and "can" in bullet 4 will also change to "may" for consistency. 

> §2.2, definition of "static": If it "typically" doesn't change, does that mean
> it sometimes does change? -- 5th paragraph: "In such a case, an
> implementation
> MAY choose to return a warning upon writing to a read-only member" MAY
> seems
> week here; does it ever make sense to silently write to a read-only member?
> 
[YJ] "MAY" will change to "SHOULD".

> Appendix A: The appendix seems more like a liaison statement than
> something
> that belongs in an RFC defining a data model. Won't this become outdated
> whenever the change of control is (or is not) made? If it does need to go in an
> RFC, have people considered publishing it separately from the model?
> 
[YJ] My opinion is: the appendix can be published alone, similar to RFC 4663. But I'd like to hear more opinion from my coauthor Rodney on this issue, as he contributed most materials in this appendix.