[netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis

Andy Bierman <andy@yumaworks.com> Tue, 22 October 2024 17:32 UTC

Return-Path: <andy@yumaworks.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 01913C15154E for <netmod@ietfa.amsl.com>; Tue, 22 Oct 2024 10:32:01 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.104
X-Spam-Level:
X-Spam-Status: No, score=-2.104 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, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_BLOCKED=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_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yumaworks.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 CHAyqMVUWoRm for <netmod@ietfa.amsl.com>; Tue, 22 Oct 2024 10:31:56 -0700 (PDT)
Received: from mail-pj1-x102d.google.com (mail-pj1-x102d.google.com [IPv6:2607:f8b0:4864:20::102d]) (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 1715EC14CF0C for <netmod@ietf.org>; Tue, 22 Oct 2024 10:31:56 -0700 (PDT)
Received: by mail-pj1-x102d.google.com with SMTP id 98e67ed59e1d1-2e2b71fd16fso955107a91.3 for <netmod@ietf.org>; Tue, 22 Oct 2024 10:31:56 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yumaworks.com; s=google; t=1729618315; x=1730223115; darn=ietf.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=r4+jKfd+IuB4NYnK4dPc//Z+pP9yXauvYbkzK34BMvg=; b=sW2su9imoo/Svt5tJG01JQAJs3AwNaoiIcdMsUD593M4gkPlWlQTY6AJIUJYcDjuXM I2deOzvfBxXOHjBbCvVhbXOHPD41z5F9MPYlcD3EhipUzC78C3FHt8qNSEPCy1+SiTze s2UM1P8ottDa2ecaMT0m8Twl5aYZ4jVWuRq9RO6Z0s9gcyAfMmgxjwwK3waFE5P4Znod 6aVFrgaLPJazDm31kg8v209SPCFaVNDBGscGYssqwCKQhBARH741C7UlhfyEAPbpo5Ln oZY1lJo9bUXGpHAw0xmKt0U6+hJbIW7b9Vj/8Ml7vUVN4ExsvoaDziqhxAfClyxcxFr3 b6nQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1729618315; x=1730223115; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=r4+jKfd+IuB4NYnK4dPc//Z+pP9yXauvYbkzK34BMvg=; b=hq64FY+pNHrYoqvdrylUf2pG27xoBOsqYkXTBk7Hnb85O2MN9snUuUG17Rk2lPo44D +l/fBESHBnpdIzGzRNY3JQvORM6D76uY0KdK0quoWg7jObQz5ffklWOlaD3K0/H6EDmi 8a+mtVOBB3ZJx9urJVIoO1YNu+188k487KV5ZxvSMN1nrdvDcP+a05vytYdFuVzz1Dyv 4uwOM+cYocr3/BVWmOF/7Z/KsHkkzhrErJSghxlED7RIKOls57LOOmnJn/H5CpMd1ZV8 AjcVqWTAisiGv1gfokKacujIm2Yp2Atixl+9Rsu6oc4fwlnDfaZfKTQ+UFh22Zn7J0c2 LFEw==
X-Forwarded-Encrypted: i=1; AJvYcCVB/oHMzYAnl38qtWrm/rBzDoNAGl1W1yRLmS6RYT9F2KqJhacMj1v3GIImfAd5N1Cca+Af3Mo=@ietf.org
X-Gm-Message-State: AOJu0YzFZ9RdE4jiYTTQEq9v1IjICd2Suh4bUUIFZRw3BD0mXdyoxARm jAybxuwKv6vkUReMuXSiN0svrqFNlEuBNVS8Sgx+u0qrw3i2B/VX2n/v0N22IZ+RsIMsIg1m/5r Yh3pSSQZdWPhiBi3kvroJi61OczRJQnlDQPD5Uw==
X-Google-Smtp-Source: AGHT+IGl8ELlyOojznoJwQtFyU59AfAJs+Tfs0sxcmgtL17r4NerIAYk/3Tw1GzVaMlKmdPIfGNvXfIkOKWsW+Wxlgw=
X-Received: by 2002:a17:90b:1889:b0:2e2:c1e5:2df3 with SMTP id 98e67ed59e1d1-2e561856753mr7501692a91.8.1729618315259; Tue, 22 Oct 2024 10:31:55 -0700 (PDT)
MIME-Version: 1.0
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> <DU2PR02MB10160F06D1B981EF21FD3E2AE88792@DU2PR02MB10160.eurprd02.prod.outlook.com> <7808C613-1D00-4CD9-AE77-CD31A5DBA64E@gmail.com> <DU2PR02MB101607E90C5B149C450030DA188442@DU2PR02MB10160.eurprd02.prod.outlook.com> <CABCOCHR7350peqjhmRzvaP36uUvaZ2TyRwTvEinBs_o8B_HUCg@mail.gmail.com> <DU2PR02MB10160E0626A79F0128A5F9BBC88452@DU2PR02MB10160.eurprd02.prod.outlook.com> <dab6e745-987c-44b2-b484-a0a4e4af18a4@labn.net> <DU2PR02MB10160A5AA023021CAB5FF7E8C884C2@DU2PR02MB10160.eurprd02.prod.outlook.com> <SJ0PR14MB4792BA12C90CFBA1FF7DD934C34C2@SJ0PR14MB4792.namprd14.prod.outlook.com> <DU2PR02MB101604B69B5609657ED45FB2D884C2@DU2PR02MB10160.eurprd02.prod.outlook.com> <SJ0PR14MB47920236CA439CF253AA6E7BC34C2@SJ0PR14MB4792.namprd14.prod.outlook.com>
In-Reply-To: <SJ0PR14MB47920236CA439CF253AA6E7BC34C2@SJ0PR14MB4792.namprd14.prod.outlook.com>
From: Andy Bierman <andy@yumaworks.com>
Date: Tue, 22 Oct 2024 10:31:43 -0700
Message-ID: <CABCOCHReH3Ne0q=rwU0631nfMO6vaG0uYk+uV8Q32XTMzQNx5Q@mail.gmail.com>
To: Lou Berger <lberger@labn.net>
Content-Type: multipart/alternative; boundary="00000000000047600f0625142530"
Message-ID-Hash: 7F7HZHCLKK675AL7ECRM37FUF5ATGGQC
X-Message-ID-Hash: 7F7HZHCLKK675AL7ECRM37FUF5ATGGQC
X-MailFrom: andy@yumaworks.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>, Jan Lindblad <jlindbla@cisco.com>, Kent Watsen <kent+ietf@watsen.net>
X-Mailman-Version: 3.3.9rc6
Precedence: list
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/1tvR4EalGL-uVUMACulIo7UtKnk>
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>

On Tue, Oct 22, 2024 at 8:28 AM Lou Berger <lberger@labn.net> wrote:

> Med,
>
> ----------
> On October 22, 2024 8:22:47 AM mohamed.boucadair@orange.com wrote:
>
> > Re-,
> >
> > Can you please indicate why you think this is a bad option? What is the
> harm in recording an option that matches current practice?
> >
>
> Is there an example of a published rfc that points to the full tree via a
> URL?
>
> As far as I read the discussion, no one was agreeing that this approach
> was a good idea.
>

Here is the original guideline text:
https://datatracker.ietf.org/doc/html/rfc8407#section-3.4

There is no text describing the conditions where a tree diagram MAY be
omitted.
The original intent was that not all modules would generate any tree output
(e.g. typedefs and identities only).

IMO if the tree diagram is really long then it is even more important to
have in the RFC
to help readers understand the data model.

A tree diagram is not considered to be a Code Component. It is just a
diagram.
This would be an odd precedent to omit diagrams from RFCs so they can be
hosted somewhere else.
There are legal and other issues with that. There is an expectation that
the IETF hosts complete RFCs.



Thanks,
> Lou
>


Andy


>
> > I remember that you indicated that you are using an electronic device to
> read docs. You can still browse the tree from the supplied URL.
> >
> > Cheers,
> > Med
> >
> > De : Lou Berger <lberger@labn.net>
> > Envoyé : mardi 22 octobre 2024 14:00
> > À : BOUCADAIR Mohamed INNOV/NET <mohamed.boucadair@orange.com>; Lou
> Berger <lberger@labn.net>; Andy Bierman <andy@yumaworks.com>
> > Cc : Mahesh Jethanandani <mjethanandani@gmail.com>; netmod@ietf.org;
> draft-ietf-netmod-rfc8407bis@ietf.org; Jan Lindblad <jlindbla@cisco.com>;
> Kent Watsen <kent+ietf@watsen.net>
> > Objet : RE: [netmod] WGLC on draft-ietf-netmod-rfc8407bis
> >
> >
> > Med,
> >
> > ----------
> > On October 22, 2024 1:21:31 AM mohamed.boucadair@orange.com<mailto:
> mohamed.boucadair@orange.com> wrote:
> >
> >> Hi Lou,
> >>
> >> Kent rightfully raised the point about the troubles with long trees
> that exceeds the max line thing. I also clarified that, e.g.,
> >>
> >
> > This is separate and unrelated topic, talking about inclusion of full
> trees in appendices as is currenty allowed for in rfc8340.
> >
> >>   *   Existing specs have provisions for tree diagrams to be included
> “as a whole, by one or more sections, or even by subsets of nodes” (8340)
> >
> > Yes I'm familiar with that text :-)
> >
> >>   *   There are RFCs out there that do not include them.
> >>
> >
> > Sure, which is also allowed for in rfc8340
> >
> >> This is a MAY after all. We can't mandate that every doc MUST include
> the full tree anyway. Are you asking for that?
> >
> > Absolutely not. I'm not quite sure what give you that impression. I just
> would like to see the additional option removed as I think it is a bad idea.
> >
> > Thanks,
> > Lou
> >
> >>
> >> Cheers,
> >> Med
> >>
> >>> -----Message d'origine-----
> >>> De : Lou Berger <lberger@labn.net<mailto:lberger@labn.net>>
> >>> Envoyé : lundi 21 octobre 2024 23:38
> >>> À : BOUCADAIR Mohamed INNOV/NET <mohamed.boucadair@orange.com<mailto:
> mohamed.boucadair@orange.com>>;
> >>> Andy Bierman <andy@yumaworks.com<mailto:andy@yumaworks.com>>
> >>> Cc : Mahesh Jethanandani <mjethanandani@gmail.com<mailto:
> mjethanandani@gmail.com>>;
> >>> netmod@ietf.org<mailto:netmod@ietf.org>;
> draft-ietf-netmod-rfc8407bis@ietf.org<mailto:
> draft-ietf-netmod-rfc8407bis@ietf.org>; Jan
> >>> Lindblad <jlindbla@cisco.com<mailto:jlindbla@cisco.com>>; Kent Watsen
> <kent+ietf@watsen.net<mailto:kent+ietf@watsen.net>>
> >>> Objet : Re: [netmod] WGLC on draft-ietf-netmod-rfc8407bis
> >>>
> >>>
> >>> Hi.
> >>>
> >>> Looking at today's (-20) version of the document, I still see
> >>> stable pointers as an option.  I really don't see the support for
> >>> this in the overall discussion and I personally think such is a
> >>> *bad* idea.
> >>>
> >>> I'd prefer that any references to the "stable pointer" option be
> >>> removed from the document.
> >>>
> >>> Thanks,
> >>>
> >>> Lou
> >>>
> >>> On 10/15/2024 2:22 AM, mohamed.boucadair@orange.com<mailto:
> mohamed.boucadair@orange.com> wrote:
> >>> > Hi Andy,
> >>> >
> >>> > RFC8340 leaves it to the authors to include it or not. It uses
> >>> statements such as "When long diagrams are included in a document,
> >>> .."
> >>> >
> >>> > An outcome of the discussion is that we can't impose one option
> >>> here. For example, the current situation is that we do already
> >>> have RFCs (RFC7407, RFC9182, RFC9291, etc.) that do not include
> >>> the full trees because these are too long, the narrative text is
> >>> good enough, the document itself is +150 pages, etc. Also,
> >>> including pages and pages of text that exceeds the max line is not
> >>> convenient for readers.
> >>> >
> >>> > The new guidelines include a provision for when the full tree is
> >>> not included for better consistency among published documents.
> >>> >
> >>> > Cheers,
> >>> > Med
> >>> >
> >>> >> -----Message d'origine-----
> >>> >> De : Andy Bierman <andy@yumaworks.com<mailto:andy@yumaworks.com>>
> Envoyé : lundi 14
> >>> octobre 2024
> >>> >> 18:24 À : BOUCADAIR Mohamed INNOV/NET
> >>> <mohamed.boucadair@orange.com<mailto:mohamed.boucadair@orange.com>>
> >>> >> Cc : Mahesh Jethanandani <mjethanandani@gmail.com<mailto:
> mjethanandani@gmail.com>>; Lou Berger
> >>> >> <lberger@labn.net<mailto:lberger@labn.net>>; netmod@ietf.org
> <mailto:netmod@ietf.org>; draft-ietf-netmod-
> >>> >> rfc8407bis@ietf.org<mailto:rfc8407bis@ietf.org>; Jan Lindblad <
> jlindbla@cisco.com<mailto:jlindbla@cisco.com>>; Kent
> >>> Watsen
> >>> >> <kent+ietf@watsen.net<mailto:kent+ietf@watsen.net>> Objet : Re:
> [netmod] WGLC on
> >>> >> draft-ietf-netmod-rfc8407bis
> >>> >>
> >>> >>
> >>> >> Hi,
> >>> >>
> >>> >> IMO we do not need new procedures to save the reader from a few
> >>> extra
> >>> >> pages of YANG tree diagram text.
> >>> >>
> >>> >> This is the only option that makes sense to me:
> >>> >>
> >>> >>     *  Include the full tree in an appendix.
> >>> >>
> >>> >> Andy
> >>> >>
> >>> >> On Sun, Oct 13, 2024 at 10:19 PM <mohamed.boucadair@orange.com
> <mailto:mohamed.boucadair@orange.com>>
> >>> >> wrote:
> >>> >>
> >>> >>> Hi Mahesh,
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Yes, this refers to the main body per the structure in
> >>> >> rfc7322#section-4.
> >>> >>> Updated accordingly.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> The diff is available using the same link: Diff:
> >>> >>> draft-ietf-netmod-rfc8407bis.txt - draft-ietf-netmod-
> >>> >> rfc8407bis.txt
> >>> >>
> >>> <https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2<
> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%252>
> >>> >> Faut
> >>> >>> hor-
> >>> >> tools.ietf.org<http://tools.ietf.org/
> >%2Fapi%2Fiddiff%3Furl_1%3Dhttps%3A%2F%2Fnetmod-
> >>> wg.gi
> >>> >>> thub.io<http://thub.io/>%2Frfc8407bis%2Fdraft-ietf-netmod-
> >>> >> rfc8407bis.txt%26url_2%3Dhttp
> >>> >>> s%3A%2F%2Fnetmod-wg.github.io<http://2fnetmod-wg.github.io/
> >%2Frfc8407bis%2Flong-
> >>> trees%2Fdraft-
> >>> >> ietf-n
> >>> >>> etmod-
> >>> >>
> >>> rfc8407bis.txt&data=05%7C02%7Cmohamed.boucadair%40orange.com<
> http://40orange.com/>%7C3
> >>> >>
> >>> 60a053d61314c7851bc08dcec6c99f5%7C90c7a20af34b40bfbc48b9253b6f5d20
> >>> >> %7C0
> >>> >>
> >>> %7C0%7C638645198411517106%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAw
> >>> >> MDAi
> >>> >>
> >>> LCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&sdata=
> >>> >> PUXU
> >>> >>> FFa2G1oGYjtnRYtC9hFJkRu5Nx%2FISQob3izoYds%3D&reserved=0>
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Thanks.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Cheers,
> >>> >>>
> >>> >>> Med
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> *De :* Mahesh Jethanandani <mjethanandani@gmail.com<mailto:
> mjethanandani@gmail.com>> *Envoyé
> >>> :*
> >>> >> samedi
> >>> >>> 12 octobre 2024 01:54 *À :* BOUCADAIR Mohamed INNOV/NET
> >>> >>> <mohamed.boucadair@orange.com<mailto:mohamed.boucadair@orange.com>>
> *Cc :* Lou Berger
> >>> >> <lberger@labn.net<mailto:lberger@labn.net>>;
> >>> >>> netmod@ietf.org<mailto:netmod@ietf.org>;
> draft-ietf-netmod-rfc8407bis@ietf.org<mailto:
> draft-ietf-netmod-rfc8407bis@ietf.org>; Jan
> >>> >> Lindblad
> >>> >>> <jlindbla@cisco.com<mailto:jlindbla@cisco.com>>; Kent Watsen <
> kent+ietf@watsen.net<mailto:kent+ietf@watsen.net>>
> >>> *Objet
> >>> >> :* Re:
> >>> >>> [netmod] WGLC on draft-ietf-netmod-rfc8407bis
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Hi Med,
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Speaking as a contributor ...
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> On Oct 11, 2024, at 8:47 AM, mohamed.boucadair@orange.com<mailto:
> mohamed.boucadair@orange.com>
> >>> wrote:
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Hi Lou, Kent, all,
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Taking into account the feedback received so far, I suggest
> >>> the
> >>> >>> following
> >>> >>> change:
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> OLD:
> >>> >>>
> >>> >>>     YANG tree diagrams provide a concise representation of a
> >>> YANG
> >>> >>> module
> >>> >>>
> >>> >>>     and SHOULD be included to help readers understand YANG
> >>> module
> >>> >>>
> >>> >>>     structure.  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.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> NEW:
> >>> >>>
> >>> >>>     YANG tree diagrams provide a concise representation of a
> >>> YANG
> >>> >>> module
> >>> >>>
> >>> >>>     and SHOULD be included to help readers understand YANG
> >>> module
> >>> >>>
> >>> >>>     structure.  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 main document.  Instead, authors MAY
> >>> >> consider
> >>> >>>     the following options:
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> [mj] Not clear what you mean by “main document”. Do you mean
> >>> the
> >>> >>> normative section of the document? If so, please edit it to
> >>> say
> >>> >> that.
> >>> >>>
> >>> >>>
> >>> >>> Thanks
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>     *  Provide only a stable pointer to retrieve the full
> >>> tree.
> >>> >> The
> >>> >>> full
> >>> >>>
> >>> >>>        tree is thus not provided at all.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>     *  Include a note about how to generate the full tree.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>     *  A combination of the first and second bullets.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>     *  Include the full tree in an appendix.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> For convenience:
> >>> >>>
> >>> >>>     - Diff: Diff: draft-ietf-netmod-rfc8407bis.txt -
> >>> >>>     draft-ietf-netmod-rfc8407bis.txt
> >>> >>>
> >>> >>
> >>> <https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2<
> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%252>
> >>> >> Fauthor-
> >>> >> tools.ietf.org<http://tools.ietf.org/
> >%2Fapi%2Fiddiff%3Furl_1%3Dhttps%3A%2F%2Fnetmod-
> >>> >> wg.github.io<http://wg.github.io/
> >%2Frfc8407bis%2Fdraft-ietf-netmod-
> >>> >> rfc8407bis.txt%26url_2%3Dhttps%3A%2F%2Fnetmod-
> >>> >> wg.github.io<http://wg.github.io/
> >%2Frfc8407bis%2Flong-trees%2Fdraft-ietf-netmod-
> >>> >>
> >>> rfc8407bis.txt&data=05%7C02%7Cmohamed.boucadair%40orange.com<
> http://40orange.com/>%7C360
> >>> >>
> >>> a053d61314c7851bc08dcec6c99f5%7C90c7a20af34b40bfbc48b9253b6f5d20%7
> >>> >>
> >>> C0%7C0%7C638645198411540339%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLj
> >>> >>
> >>> AwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&
> >>> >>
> >>> sdata=68CtKMDgxzWjl4IsKqxJlSLpvOHAflb0Cv5TQFwExN0%3D&reserved=0>
> >>> >>>     - PR:
> >>> >>>
> >>> >>
> >>> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> >>> >> gith
> >>> >>> ub.com<http://ub.com/>%2Fnetmod-
> >>> >> wg%2Frfc8407bis%2Fpull%2F70%2Ffiles&data=05%7C02%7Cmoh
> >>> >>
> >>> amed.boucadair%40orange.com<http://40orange.com/
> >%7C360a053d61314c7851bc08dcec6c99f5%7C9
> >>> >> 0c7a
> >>> >>
> >>> 20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C638645198411557810%7CUnknown
> >>> >> %7CT
> >>> >>
> >>> WFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJ
> >>> >> XVCI
> >>> >>
> >>> 6Mn0%3D%7C0%7C%7C%7C&sdata=%2BkYIcnZV7Wwi4tUS6uOObRMUMcdt4xxyiNBOW
> >>> >> QXGp
> >>> >>> wE%3D&reserved=0
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Better?
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Cheers,
> >>> >>>
> >>> >>> Med
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> *De :* BOUCADAIR Mohamed INNOV/NET
> >>> >>> *Envoyé :* mercredi 2 octobre 2024 11:13 *À :* 'Lou Berger'
> >>> >>> <lberger@labn.net<mailto:lberger@labn.net>>; netmod@ietf.org
> <mailto:netmod@ietf.org>;
> >>> >>> draft-ietf-netmod-rfc8407bis@ietf.org<mailto:
> draft-ietf-netmod-rfc8407bis@ietf.org>; Jan Lindblad (jlindbla)
> >>> <
> >>> >>> jlindbla@cisco.com<mailto:jlindbla@cisco.com>> *Cc :* Kent Watsen
> <kent+ietf@watsen.net<mailto:kent+ietf@watsen.net>>
> >>> >> *Objet
> >>> >>> :* RE: [netmod] Re: WGLC on draft-ietf-netmod-rfc8407bis
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Hi Lou,
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>     - Keeping long trees in the main document is really not
> >>> >> helpful to
> >>> >>>     digest a module. I also know by experience that this
> >>> raises
> >>> >> comments,
> >>> >>>     including from the IESG.
> >>> >>>     - Keeping long trees that exceed 69 line max in the main
> >>> or
> >>> >> as an
> >>> >>>     appendix is really hard to follow.
> >>> >>>     - There are already RFCs out there do not include long
> >>> trees,
> >>> >> but a
> >>> >>>     note about how to generate it. The narrative text uses
> >>> small
> >>> >> snippets to
> >>> >>>     help readers walk through the model.
> >>> >>>     - Some consistency is needed in how we document our
> >>> modules +
> >>> >> help
> >>> >>>     authors with clear guidance (e.g., characterize what is a
> >>> >> long
> >>> >>> tree)
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> I’m afraid that we can’t simply leave the OLD 8407 as it is.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> That’s said, I’m only the pen holder and will implement
> >>> whatever
> >>> >> the
> >>> >>> WG decides here.
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Cheers,
> >>> >>>
> >>> >>> Med
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> *De :* Lou Berger <lberger@labn.net<mailto:lberger@labn.net>>
> *Envoyé :* mardi 1
> >>> octobre 2024
> >>> >>> 13:37 *À :* BOUCADAIR Mohamed INNOV/NET
> >>> >> <mohamed.boucadair@orange.com<mailto:mohamed.boucadair@orange.com
> >>;
> >>> >>> netmod@ietf.org<mailto:netmod@ietf.org>;
> draft-ietf-netmod-rfc8407bis@ietf.org<mailto:
> draft-ietf-netmod-rfc8407bis@ietf.org>; Jan
> >>> >> Lindblad
> >>> >>> (jlindbla) <jlindbla@cisco.com<mailto:jlindbla@cisco.com>>
> >>> >>> *Cc :* Kent Watsen <kent+ietf@watsen.net<mailto:
> kent+ietf@watsen.net>> *Objet :* Re:
> >>> [netmod]
> >>> >> Re:
> >>> >>> WGLC on draft-ietf-netmod-rfc8407bis
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>> Med, Jan, WG,
> >>> >>>
> >>> >>> I have to say that I read the discussion concluding with to
> >>> NOT
> >>> >> change
> >>> >>> the current recommendation, see
> >>> >>>
> >>> >>
> >>> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> >>> >> mail
> >>> >>> archive.ietf.org<http://archive.ietf.org/
> >%2Farch%2Fmsg%2Fnetmod%2F0Q0YiyNi15V-
> >>> Szzf5awLVh-
> >>> >> 15_c%2
> >>> >>
> >>> F&data=05%7C02%7Cmohamed.boucadair%40orange.com<http://40orange.com/
> >%7C360a053d61314c78
> >>> >> 51bc
> >>> >>
> >>> 08dcec6c99f5%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C63864519
> >>> >> 8411
> >>> >>
> >>> 573595%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzI
> >>> >> iLCJ
> >>> >>
> >>> BTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&sdata=FuJbQGSOk7%2FkMXATR
> >>> >> 1fn3
> >>> >>> YScP4MBfkRWYvYXz90NyNI%3D&reserved=0
> >>> >>>
> >>> >>> 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.  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.
> >>> >>>
> >>> >>> 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.)
> >>> >>>
> >>> >>> Thanks,
> >>> >>>
> >>> >>> Lou
> >>> >>>
> >>> >>> On 10/1/2024 4:24 AM, mohamed.boucadair@orange.com<mailto:
> mohamed.boucadair@orange.com> wrote:
> >>> >>>
> >>> >>> Hi Lou,
> >>> >>>
> >>> >>>
> >>> >>>
> >>> >>>     1. The comment that triggered the change and companion
> >>> thread
> >>> >> where
> >>> >>>     this was discussed and changes proposed can be seen at:
> >>> >>>
> >>> >>>
> >>> >>
> >>> https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> >>> >> mail
> >>> >>> archive.ietf.org<http://archive.ietf.org/
> >%2Farch%2Fmsg%2Fnetmod%2F-
> >>> >>
> >>> b2HX0XUK49qJB19LHu6MC0D9zc%2F&data=05%7C02%7Cmohamed.boucadair%40o
> >>> >>
> >>> range.com<http://range.com/
> >%7C360a053d61314c7851bc08dcec6c99f5%7C90c7a20af34b40bfbc4
> >>> >>
> >>> 8b9253b6f5d20%7C0%7C0%7C638645198411584985%7CUnknown%7CTWFpbGZsb3d
> >>> >>
> >>> 8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3
> >>> >>
> >>> D%7C0%7C%7C%7C&sdata=r4xdN4asqklRHaI%2BIixWX29CCw7i1QBlmAHlNXrKjng
> >>> >> %3D&reserved=0
> >>> >
> >>> __________________________________________________________________
> >>> ____
> >>> > ______________________________________
> >>> > 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.
> >>
> ____________________________________________________________________________________________________________
> >> 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.
> >
> >
> ____________________________________________________________________________________________________________
> > 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.
>