Hi Kent, Added a reference to 8792 for better clarity.
I agree that the command does not always produce diagrams that fit into 69-columns. Such cases fall under the “exceptionally, ..” of the SHOULD. The command works without “=”. Please see https://wiki.ietf.org/group/ops/yang-review-tools. The changes can be tracked here: https://author-tools.ietf.org/api/iddiff?url_1=https://netmod-wg.github.io/rfc8407bis/draft-ietf-netmod-rfc8407bis.txt&url_2=https://netmod-wg.github.io/rfc8407bis/clarifications-from-nit/draft-ietf-netmod-rfc8407bis.txt Cheers, Med De : Kent Watsen <[email protected]> Envoyé : mardi 1 octobre 2024 02:00 À : [email protected]; [email protected] Objet : [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Hi, I also have a late comment as contributor on this draft (based on a co-chair discussion). Looking at the diff relative of Section 3.4, there is mention of folding (search “unfold”). Is this intended to point to RFC 8792 and, if so, should that be clarified? I’m aware that the folding of tree diagrams was discussed on the list recently, but please be aware that the “--tree-line-length=69” parameter to the `pyang` utility is not always able to make the diagram fit into 69-columns. Separately, I notice the document mentions twice "--yang-line-length 69”. I believe that the ‘=‘ character is missing, i.e., it should be "--yang-line-length=69”. Thanks, Kent (and Lou) On Sep 30, 2024, at 6:23 PM, Lou Berger <[email protected]<mailto:[email protected]>> wrote: Hi, I have a late comment as contributor on this draft (based on a co-chair discussion). Looking at the diff relative of section 3.4 to the original document, I think the idea of referencing a URL versus an appendix is a bad idea. The new text in question: " If the complete tree diagram for a module becomes long (more than 2 pages, typically), the diagram SHOULD be split into several smaller diagrams (a.k.a subtrees). For the reader's convenience, a subtree should fit within a page. If the complete tree diagram is too long (more than 5 pages, typically) even with groupings unexpanded (Section 2.2 of [RFC8340]), the authors SHOULD NOT include it in the document. A stable pointer to retrieve the full tree MAY be included." I prefer the original in https://www.rfc-editor.org/rfc/rfc8340#section-3.3 which (a) does not have conformance language and (b) keeps the information as available as the document itself by including the long diagram in an appendix. I would like to see this section reverted to the original. Authors, What is the motivation for the change to URLs and making this a "SHOULD NOT"? Thanks, Lou ¶<https://datatracker.ietf.org/doc/html/draft-ietf-netmod-rfc8407bis-17#section-3.4-1> On 9/20/2024 4:03 PM, Kent Watsen wrote: This WGLC has successfully closed. The document has moved to the WG State "WG Consensus: Waiting for Write-Up”. Thank you everyone, especially Med, for your diligence in resolving issues! The next step is the Shepherd write-up. Would anyone in the WG be willing to volunteer to help out with it? Thanks, Kent and Lou (chairs) On May 6, 2024, at 9:57 AM, Kent Watsen <[email protected]><mailto:[email protected]> wrote: This email begins a two-week WGLC on: Guidelines for Authors and Reviewers of Documents Containing YANG Data Models https://datatracker.ietf.org/doc/draft-ietf-netmod-rfc8407bis/ Please take time to review this draft and post comments by May 20. Favorable comments are especially welcomed. No IPR has been declared for this document: https://mailarchive.ietf.org/arch/msg/netmod/1LDpkPi_C8cqktc7HXSZgyPDCBE/ Kent & Lou (as co-chairs) _______________________________________________ netmod mailing list [email protected]<mailto:[email protected]> https://www.ietf.org/mailman/listinfo/netmod _______________________________________________ netmod mailing list -- [email protected]<mailto:[email protected]> To unsubscribe send an email to [email protected]<mailto:[email protected]> _______________________________________________ netmod mailing list -- [email protected]<mailto:[email protected]> To unsubscribe send an email to [email protected]<mailto:[email protected]> ____________________________________________________________________________________________________________ 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.
_______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]
