Re: [core] [Cbor] map (5), ordering vs YANG SID in ietf-core-yang-cbor

> On Aug 17, 2017, at 09:29, Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> wrote:
> 
> Carsten,
> 
> I looked into core-sid to understand how sids work,

That document tells you how to get SIDs.

> I did not expect
> that the definition how delta sids work is in core-cbor…

That document tells you how to encode the SIDs you have into deltas in the CBOR serialization of YANG models.

I think that is a quite reasonable division of work, but maybe again there is potential for explaining this better editorially.

One problem in the past has been that people have been referring to the deltas as SIDs — they aren’t, and we need to root any remnant of that usage out of the documents.

Grüße, Carsten

> 
> /js
> 
> On Thu, Aug 17, 2017 at 09:04:07AM +0200, Carsten Bormann wrote:
>> On Aug 17, 2017, at 08:54, Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> wrote:
>>> 
>>> Carsten,
>>> 
>>> if I search for 'delta' or 'reference SID', I do not find text that
>>> says what the reference SID is. Where do I have to look at to
>>> understand that delta SIDs are parent-referenced?
>> 
>> 4.2.1 (of yang-cbor) says:
>> 
>>   o  The delta value is equal to the SID of the current schema node
>>      minus the SID of the parent schema node.  When no parent exists in
>> 
>> But maybe there is indeed potential for editorial improvement here.
>> Clearly phrasing this always in terms of the reference SID, and then saying where that reference SID comes from (e.g., zero at the root of the tree), might help.
>> This probably also should be buttressed some more by examples.
>> 
>>> /js
>>> 
>>> PS: Why do we have this, I mean, why is there a $ for some of these?
>>> 
>>>          pattern 'Module|Submodule|feature|' +
>>> 	           'identity$|node$|notification$|rpc$|action$';
>>> 
>>>   Why is this not an enum in the first place? And why are the
>>>   first two capitalized?
>> 
>> (Now you are in core-sid, I think.)
>> Good questions; I’d defer to the YANG specialists here.
>> 
>>> PS: Why do you not import yang-identifier from ietf-yang-types?
>> 
>> Ditto.
>> 
>> Grüße, Carsten
>> 
> 
> -- 
> Juergen Schoenwaelder           Jacobs University Bremen gGmbH
> Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
> Fax:   +49 421 200 3103         <http://www.jacobs-university.de/>
> 
> _______________________________________________
> CBOR mailing list
> CBOR@ietf.org
> https://www.ietf.org/mailman/listinfo/cbor
> 
> 