Re: [netmod] Tree diagram comment lines

[[e-mail]]

Hi all, 

Agree with Martin.

Here is the note I'm using in some RFCs with long trees:  

   The full tree diagram of the module can be generated using the
   "pyang" tool [PYANG].  That tree is not included here because it is
   too long (Section 3.3 of [RFC8340]).  Instead, subtrees are provided
   for the reader's convenience.

Cheers,
Med

> -----Message d'origine-----
> De : netmod <[e-mail]> De la part de Martin
> Björklund
> Envoyé : lundi 11 avril 2022 13:03
> À : [e-mail]
> Cc : [e-mail]
> Objet : Re: [netmod] Tree diagram comment lines
> 
> tom petch <[e-mail]> 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
> > [e-mail]
> > https://www.ietf.org/mailman/listinfo/netmod
> 
> _______________________________________________
> netmod mailing list
> [e-mail]
> https://www.ietf.org/mailman/listinfo/netmod

_________________________________________________________________________________________________________________________

Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.