[netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis
Reshad Rahman <reshad@yahoo.com> Wed, 02 October 2024 02:33 UTC
Return-Path: <reshad@yahoo.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 239ABC1CAF45 for <netmod@ietfa.amsl.com>; Tue, 1 Oct 2024 19:33:28 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.105
X-Spam-Level:
X-Spam-Status: No, score=-2.105 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yahoo.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id E-1rGLy1d5Mx for <netmod@ietfa.amsl.com>; Tue, 1 Oct 2024 19:33:23 -0700 (PDT)
Received: from sonic308-3.consmr.mail.bf2.yahoo.com (sonic308-3.consmr.mail.bf2.yahoo.com [74.6.130.42]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CFD2EC1CAF43 for <netmod@ietf.org>; Tue, 1 Oct 2024 19:33:22 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1727836401; bh=zKJBZcjBRWwRP4xjG4bNAfMAq/YT9lYq66vPKmrDVAU=; h=Date:From:Reply-To:To:Cc:In-Reply-To:References:Subject:From:Subject:Reply-To; b=LxqWEhMPfBwIouyE7KWjS7VaudUsq2N5HaoXCpi/2RmQQPof0BU4b6NcIcEiJ35Vn4RxPGjzWx2ew2oCwlbM3MkTlAlBkQofvxsHu922YkirCltRLlvF2zCpURhAXSb7emC5y2grEfXSOasI76eIuuGlLzBkpwRH5g/Mmj8O77KsvIdhVgL8YVlWO7rYjKGz2jkPFWsvI+mZB+EQy0ZjkGUCp/NFwB0rWOQoIoJrIBI8akNJNaCgboEGNiVijumpsqNyCYLc0uOXvVuml5d+zcGj6nzLhHXyMUAb+OjZbn1x3hLyo9DWCkw02WYzXiQt7RscNheLFPnYhC6VpNJtAA==
X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1727836401; bh=QaYVrAttrQ41kx0Ed+UPwoSOEDYc0lrRf6hxJxQM7VU=; h=X-Sonic-MF:Date:From:To:Subject:From:Subject; b=DrRwlvXwOuuE604Y8JfrQwFAMYr3aLoP8nNd6qwTNZ/YC95nbHi8n5oaqoSgunyBL/kzDtlmyMduMIoLV3fVPGafjS9FCeYvE/HEb2eIwnU/dPubenNIA9BbVKe9g3BMHdWVOpko1b4vl25nrmrqocOiLa9LhroDkjo3egkU+nz47SC6RuQlI+tfAfM9zxeFhLeXHRFdgeVfGke/Tlk3a+/Oixdsiski9Ca4+KBoETUlqBFgcqDD5lOGUpJraiVERRb8gzhHHpn4EcWljK9za1M+YC5V/8oL+0FwsM2GgSK+A7+lRS7w8ay6HrQ1ivRvt/h0zRbwUUzi6C4HkyyXwQ==
X-YMail-OSG: l59yoGoVM1m7eAyLvmpo4cNpCpeUlol2gEYfE1V4eImkv8NKIm6vHBhPvkruJF8 JPmaLQ3Y2CQ362RsuJlyYnr_rnFTo9PATlcB7Egk8_Lu8y1n2fpqncff4G9ZRPI1w5.7OkTrdoy8 qoqQk1f_22D5j9RJvlgN71CHW_n3co0RaKdFyZxiECJ3IxR4bOclAhDgX5y7fCm38nDPj1WtwxRc nVe2575aVUPGiMSa9QLn.IMCPFDzejhHvHQYM0c3eszh5Kz0U0RCRhp1ipkmhMovspLYbRbxGij4 ctsQ52QHgcTdlxt8OJZR1EdLnF4IzZ11gea49bxYG2hlwhd3bnCKAXczl1FTlfsPQPVgGYaWsgLh T4b9VdTFUWn9RnO8RqkoMFnG8Zs6AEOVmqgKMY5845pQQ__KAlYutXQnrPAGQrqVoPdQii1U4JpP Kq3vCBXG7eFqkRkhTVgQjmVJi8.sP8JVb4UocEGsRoIaxG04FNl.Iuw6tVzg0Gi5wiEeZuFY4ooO BXuuDXpzTtRQ7uuSNxG5LF9y0vvm2kd5kuGA1w1G.kNQnisu4uR3svQOrSBgfGOmMQcw0GnZ.O0F Ik_a59oHSo0a5KLfR4zjld9vzrUEEHnQtuUELtxw9npCAbMfSWIPYzo47OvFfhaVpC4okSlAUR5e EkGrdCKxMe.4Gt8qxbCfKWHxiYvDDpdvtmGwiouLs1d_9GRPcU_4pnJyK21Skp_APg4PkJry9SsC vjtUUBW4IqIuZxjmeCGPnNOIbm0skQwXyiKccO2cdV3nFcA3x9yBwBcDY6q_ZjyGKDS9iYKoqpz. AYgTGCkM.Dbzl80ei7D_GPiapFAOGKXurWRu1Q2xeavigIGIAJ3Vz.JcwTMf2PnO2llYI5Qd_92D cBPU..ChpOLh77ypP0CdQ3N7oNy1iuV848ePYXZSQlKBtVmiObBOq30OApCtqxKC05Xh.zvucJSh lUU0VABRfcgBh3.p6VjTqY5mTvONDzv_V8sGpR5r.aZv2B1Cnpidz.SVQv7CnN8v2wfFacN8FLRV LD8qQFtUhm3OG1N8AOq0_6keA8dmk9fAJM9LckD0WC2L9B_VhDsqtAWtSwEtKExwGei3pwW3wwo2 YVhSavds2TaSi7hcO39gW151xIvtUj9EvedFtjFebgokS4oPlCbBCsRgRkRs5lkk_RgNY9B1C0FC kdBLGVNVxb5Fwbumm59FmJgPFoINta67YZgViemXrK15BLCPfLcso3iSVHonKXXsebw34Z1L2J0_ L_BZya.WpZ9qGjJTlBg.bcjKbEpQMPMhkylOSan..j1wMZkQjCWeHDP1JmG_EmJ51cKinYtsXozD 6MoVKQnxr2VJIw7t7BqduhEL0ADLI_D.tWeOHcYUS8toGwSbjV5MwO6J3j7OGnNxlujk0G13Belr X2AOcOed6CuOlWQKue9_vf0oYBi4iJPUKs4xTIJqqWMX84.Ea4gUAgvs_AruMpxHQjzzpSfLtYMO bWnVVGbyTwXatgiiAKcElAozI2dL4DcVxkdDNxrhk2t6rC7SXTbcEMo61B7oT66_EYzq4fM3bODd i8lJ9ymjnEQ51BmfYwnYWepzPOmT8x3hm4YB0Er03Zbe.ZbT1xQ1C8Tn.yqye2YxqOAAJAi8VlJR ig6ZhN9XRPS65H8s8oLWcS8Nq4lXt4iF0DNFjQh5rdIhrjKwnwfEO.T73suFiTbM_xYxLYIRhc8x r.BdpsB8zOkwxB.idmETSboGaf2j52S9veY1q4_aLalDpnZNcJnPpW2wJlwEQSGX6jiHqrbCbs5f aTymIqXQ2LKz7x_zafTdDLG2NzXU3YDER5aJJghkylI39KBy8sG0EszvBfBfHIqq6k3St7Eq8jiP EyNfCdREGbYsxiBBXHvF5Ctl_O9ytnAifKtQZrGokMPaR0tFTxK1Vm11OAUEnIKte4zlbc310JcM sI1q5LSlbx5iGAArgmi45Hlom4.V5hYgyA5pEqEJqz46oYr3I_itJtX60Fv6cLeyTG8fW9w2Sj10 cy6z2XDxggg8sspcpCeNLCif13aBYpAfMH0fQuj7t2LTPEzkK1zBgJEQ5XP1MRUbFcTNlyNAFpOt JwH9mr.w4dAwnJELZx9cT3ksKYhYUD8ZvzroxYNK2YGPsOZ6YR9gymoisjhjc9aJMzn6ep_TYvg9 .24tkhLTOF6ZFHYg7DLcK029rEir45V5jOkxVGd8IwxGrGa66jDBEFPEOtN2hzwKtf6lYWr2V1Ep iTwBjXnEKvFDrTprzPnmj1uUcnxUg4esWFbZJH9.JUzFxaHRyHrmN9G1.7cu9vRvmivdnXyBgh1Z L8B85cZl0WU0ecbSLEvHV7lzDkQXpjPfeXJ4DANavHy_2V334V244xA--
X-Sonic-MF: <reshad@yahoo.com>
X-Sonic-ID: db56d7bb-26ac-46bc-8fec-ac88924d0fb1
Received: from sonic.gate.mail.ne1.yahoo.com by sonic308.consmr.mail.bf2.yahoo.com with HTTP; Wed, 2 Oct 2024 02:33:21 +0000
Date: Wed, 02 Oct 2024 02:33:20 +0000
From: Reshad Rahman <reshad@yahoo.com>
To: Lou Berger <lberger@labn.net>, Kent Watsen <kent+ietf@watsen.net>
Message-ID: <1715361927.7958008.1727836400936@mail.yahoo.com>
In-Reply-To: <0100019249bc3e07-9324d29f-5539-4c1d-b828-5e9950af4197-000000@email.amazonses.com>
References: <0100018f4e31af70-fd072689-4a32-4547-b32c-ce06781df2b5-000000@email.amazonses.com> <0100019211083dbf-15ebf66a-653f-487c-b15e-15380177c80f-000000@email.amazonses.com> <e607aa67-7c53-419c-aa5f-30c74aae7d96@labn.net> <DU2PR02MB101600DEE6F92ED7C4F88709988772@DU2PR02MB10160.eurprd02.prod.outlook.com> <d7df2a1d-3105-4707-8d9b-fb4aa44695a9@labn.net> <0100019249bc3e07-9324d29f-5539-4c1d-b828-5e9950af4197-000000@email.amazonses.com>
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="----=_Part_7958007_332402148.1727836400931"
X-Mailer: WebService/1.1.22645 YMailNorrin
Message-ID-Hash: QANJG7Y6MSVAXTVX7E44CNU7TRMO4XBH
X-Message-ID-Hash: QANJG7Y6MSVAXTVX7E44CNU7TRMO4XBH
X-MailFrom: reshad@yahoo.com
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-netmod.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: "netmod@ietf.org" <netmod@ietf.org>, "draft-ietf-netmod-rfc8407bis@ietf.org" <draft-ietf-netmod-rfc8407bis@ietf.org>
X-Mailman-Version: 3.3.9rc4
Precedence: list
Reply-To: Reshad Rahman <reshad@yahoo.com>
Subject: [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis
List-Id: NETMOD WG list <netmod.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/LJhxglvQa8ADPxOZ4OnoIwhJpWQ>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Owner: <mailto:netmod-owner@ietf.org>
List-Post: <mailto:netmod@ietf.org>
List-Subscribe: <mailto:netmod-join@ietf.org>
List-Unsubscribe: <mailto:netmod-leave@ietf.org>
Hi, Commenting on the following: html version can include SVG diagrams (e.g. https://www.rfc-editor.org/authors/rfc9633.html) so I don't see why it couldn't include a text diagram :-) But yes asking the RFC editor is the best couse of action. Furthermore, I'm not sure what our process has to say about having the HTML include *text content* that is not in the text version. I feel strongly that we should keep the full tree diagram in the document (main body or appendix). Regards,Reshad. On Tuesday, October 1, 2024 at 04:20:22 PM EDT, Kent Watsen <kent+ietf@watsen.net> wrote: Hi Lou, et. al. On Oct 1, 2024, at 7:36 AM, Lou Berger <lberger@labn.net> wrote: Med, Jan, WG, I have to say that I read the discussion concluding with to NOT change the current recommendation, see https://mailarchive.ietf.org/arch/msg/netmod/0Q0YiyNi15V-Szzf5awLVh-15_c/ I personally use an ereader (or computer) more than paper and having to go to a static URL -- probably when I'm off line -- does NOT seem like something we should be recommending. Agreed, at least not as a sole option (see "Options" at bottom) Furthermore, I'm not sure what our process has to say about having the HTML include *text content* that is not in the text version. I’m unsure as well. Something to ask RFC Editor about? Presumably RFC Editor would have to archive the linked artifacts as well - right? In any case, RFC’s can/do have hyperlinks and, if not normative, it seems technically possible to link an external artifact, as one of a few options (again, see “Options" at bottom) Again just my perspective. What do others think? do they feel strongly that this change from the current recommendation (in RFC8340) of having long trees in appendixes is a good or bad idea? (Yes, I'm in the strongly against camp.) RFC 8340 says: When long diagrams are included in a document, authors should consider whether to include the long diagram in the main body of the document or in an appendix. Which I think is fine, and I don’t see a reason to change. That said, I find that full/long diagrams sometimes exceed the 69-column limit, thus requiring RFC 8792 folding, which (for me) usually comes out looking like an absolute mess ;) Options: - Guide the reader how to use `rfcstrip` and `rfcfold` to unfold the folded diagram found in the Appendix of the plain-text version of the document. - Guild the reader how to use `rfcstrip` and `pyang` to generate the full/long diagram on their local system. - Include a pointer to a stable URL for the unfolded version of the full/long diagram - Do not include any guidance or the full/long diagrams in the Appendix. This assumes that the document did a good job linking the unexpanded groupings in the tree diagrams. - Some combination of the above? Kent / contributor Thanks, Lou On 10/1/2024 4:24 AM, mohamed.boucadair@orange.com wrote: Hi Lou, - The comment that triggered the change and companion thread where this was discussed and changes proposed can be seen at: https://mailarchive.ietf.org/arch/msg/netmod/-b2HX0XUK49qJB19LHu6MC0D9zc/. Please note that for html version can still include the long tree, The tooling may evolve in the future to provide better rendering of too long trees. This tooling may offer (but not limited to), unfold trees, control of expanded views, ease navigation among various levels of a tree, support of hyperlinks, etc. When such a tooling is available, too long trees can be displayed in the HTML version of documents that include such trees. - The candidate change was shared with the WG prior to IETF#119:https://mailarchive.ietf.org/arch/msg/netmod/x9aex0PO-KARyg5FtzjLNYrIpLY/ - The thread was open for almost 1 month and a half: https://author-tools.ietf.org/iddiff?url1=draft-ietf-netmod-rfc8407bis-09&url2=draft-ietf-netmod-rfc8407bis-10&difftype=--html Cheers,Med De : Lou Berger <lberger@labn.net> Envoyé : mardi 1 octobre 2024 00:24 À : netmod@ietf.org; draft-ietf-netmod-rfc8407bis@ietf.org Cc : Kent Watsen <kent+ietf@watsen.net> Objet : Re: [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis 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 ¶ 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 <kent+ietf@watsen.net>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 netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod _______________________________________________netmod mailing list -- netmod@ietf.orgTo unsubscribe send an email to netmod-leave@ietf.org _________________ ______________________________ ______________________________ ______________________________ _ 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 -- netmod@ietf.org To unsubscribe send an email to netmod-leave@ietf.org _______________________________________________ netmod mailing list -- netmod@ietf.org To unsubscribe send an email to netmod-leave@ietf.org
- [netmod] WGLC on draft-ietf-netmod-rfc8407bis Kent Watsen
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Kent Watsen
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Qin Wu
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Mahesh Jethanandani
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Kent Watsen
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Kent Watsen
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Reshad Rahman
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis tom petch
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Mahesh Jethanandani
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Andy Bierman
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Benoit Claise
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis tom petch
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Andy Bierman
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Andy Bierman
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Lou Berger
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis mohamed.boucadair
- [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis Andy Bierman