Re: [netmod] Tree diagram comment lines

Hi Tom,

Martin beat me on this one.
So the famous +1 to his "in combination with explanatory text to explain 
certain aspects of the module design "reply :-)
We got rid a page number for a good reason (in the YANG world).

Regards, Benoit

On 4/11/2022 1:02 PM, Martin Björklund wrote:
> tom petch <ietfc@btconnect.com> wrote:
>> Can a YANG tree diagram contain comment lines?
>>
>> draft-ietf-teas-yang-te has a tree diagram of 40 pages and since the
>> IETF has abolished the page number, then any reference into it could
>> be a challenge.  For a YANG module, this can be ameliorated by
>> inserting comment lines every page or two.
>>
>> Can this be done with tree diagrams?
> Yes, "//" introduces a (line) comment.  See 2.5 of RFC 8340.
>
> But a 40 page tree diagram isn't very useful anyway, imo.  If I want
> the full tree diagram I can run a tool to generate it.  Tree diagrams
> are best used in combination with explanatory text to explain certain
> aspects of the module design.  Perhaps section 3.4 in RFC 8407 should
> be updated to explain this.
>
>
> /martin
>
>
>
>
>> Tom Petch
>> _______________________________________________
>> netmod mailing list
>> netmod@ietf.org
>> https://www.ietf.org/mailman/listinfo/netmod
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod
> .