Re: [TICTOC] Comments on the proposed 1599v2 YANG model

[Rodney Cummings <[e-mail]>]

Hi Joe,

Thanks for the comments... very helpful.

I'd like to discuss some high level themes for your comments.

1. Regarding comments on the leafs in the YANG module (section 3):

As stated in the Introduction (section 1): "The data model is based on the PTP data sets as specified in [IEEE1588]."

Therefore, each leaf is based on the normative specifications of clause 8 of IEEE Std 1588-2008. The name of each leaf aligns 1-1 with the equivalent name of a 1588-2008 data set member. This YANG module can not change the 1588-2008 specifications. That means that the answer to most of your questions is:
	Refer to the specifications in IEEE Std 1588-2008.
For example, IEEE Std 1588-2008 specifies the units of measure for each leaf.

That being said, the description of each leaf did make an attempt to summarize the specifications of IEEE Std 1588-2008. That methodology avoids the potential for a leaf description that is pages long. Nevertheless, the summary does have the disadvantage of assuming that the reader is familiar with IEEE Std 1588-2008 specifications.

I suppose one could argue that each description should copy the text from IEEE Std 1588-2008 for each leaf, regardless of the length of that text.

Is that what you are requesting?

2. Regarding the first comment in A.4 (starting "Where is the specific make, model,").

Again, this model and module is based on IEEE Std 1588-2008, and we explicitly avoid adding new features that are outside of that standard.

There is a feature in the future IEEE 1588 revision that provides what you request, but since that 1588 revision is a work-in-progress, it is the subject of a future revision of this model/module (see bullet at top of page 4). The authors want to avoid creating a dependency between those two projects.

3. Regarding the second comment in A.4 (starting "As for the standard compliant").

YANG supports vendor-specific data through use of augments. There is no need to provide placeholders for such data. Please refer to the YANG specifications and tutorials, and see if follow up discussion is needed.

Rodney

> -----Original Message-----
> From: TICTOC [mailto:[e-mail]] On Behalf Of Joseph Gwinn
> Sent: Saturday, November 5, 2016 3:54 PM
> To: [e-mail]
> Subject: [TICTOC] Comments on the proposed 1599v2 YANG model
> 
> To the TICTOC working group:
> 
> Attached find my redlines against draft-ietf-tictoc-1588v2-yang-00
> dated 20 October 2016.
> 
> Where the arrows point should be text highlighted in yellow, but the
> yellow may be faint in some readers.
> 
> Joe Gwinn
>