Re: [netmod] Tree diagram comment lines
Kent Watsen <kent+ietf@watsen.net> Mon, 11 April 2022 11:21 UTC
Return-Path: <01000180185b65c5-e3f11060-8beb-4335-8dae-f0cbf5f3b599-000000@amazonses.watsen.net>
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 E41EA3A17F1 for <netmod@ietfa.amsl.com>; Mon, 11 Apr 2022 04:21:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.908
X-Spam-Level:
X-Spam-Status: No, score=-1.908 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=amazonses.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id yjLNmARignrK for <netmod@ietfa.amsl.com>; Mon, 11 Apr 2022 04:21:26 -0700 (PDT)
Received: from a8-88.smtp-out.amazonses.com (a8-88.smtp-out.amazonses.com [54.240.8.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D2EEC3A17EE for <netmod@ietf.org>; Mon, 11 Apr 2022 04:21:25 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1649676084; h=Content-Type:Content-Transfer-Encoding:From:Mime-Version:Subject:Date:Message-Id:References:Cc:In-Reply-To:To:Feedback-ID; bh=EiKzLxP0DGGpGK8ZM5e9NjCBanpjW2SZUEb75VHvWVw=; b=WqqM1ja8DivqwicWLZliwCr+mc8v3WMd2oHj7iIOY0QuhrtZxBIxYs+awCyFDqio +BRvHkT1/mUOhkStwGYSi/dtqKE7XKxYJ4qrQWpGTYlM9IGcQC+7FbcTVf59rhevAtM l8e0LM72ltX+m6C27en8hCe9He06W/ioD68ij5JE=
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
From: Kent Watsen <kent+ietf@watsen.net>
Mime-Version: 1.0 (1.0)
Date: Mon, 11 Apr 2022 11:21:24 +0000
Message-ID: <01000180185b65c5-e3f11060-8beb-4335-8dae-f0cbf5f3b599-000000@email.amazonses.com>
References: <20220411.130246.1026658909508971766.id@4668.se>
Cc: ietfc@btconnect.com, netmod@ietf.org
In-Reply-To: <20220411.130246.1026658909508971766.id@4668.se>
To: Martin Björklund <mbj+ietf@4668.se>
X-Mailer: iPhone Mail (18H107)
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
X-SES-Outgoing: 2022.04.11-54.240.8.88
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/_EVsh7RSFvwJRRMXzBIYgPc0nAM>
Subject: Re: [netmod] Tree diagram comment lines
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 11 Apr 2022 11:21:31 -0000
> 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. Agreed. The netconf-client-server and restconf-client-server drafts had “full” diagrams that were many pages long. Fixed by: 1) Introducing each grouping individually (I wrote a script to extract a particular grouping tree diagram) 2) Convert all diagrams to NOT expand groupings. I.e., it prints just the grouping’s name. 3) The text for each grouping includes the hyperlink to the other sections where the each used-grouping is defined. 4) Remove from the document the mostly-useless super-long diagram. K.
- [netmod] Tree diagram comment lines tom petch
- Re: [netmod] Tree diagram comment lines Lou Berger
- Re: [netmod] Tree diagram comment lines Martin Björklund
- Re: [netmod] Tree diagram comment lines Benoit Claise
- Re: [netmod] Tree diagram comment lines Kent Watsen
- Re: [netmod] Tree diagram comment lines mohamed.boucadair
- Re: [netmod] Tree diagram comment lines tom petch