Re: [netmod] stable reference for tree diagram notation

Ladislav Lhotka <lhotka@nic.cz> Thu, 09 March 2017 11:42 UTC

Return-Path: <lhotka@nic.cz>
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 977C5129547 for <netmod@ietfa.amsl.com>; Thu, 9 Mar 2017 03:42:06 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7.02
X-Spam-Level:
X-Spam-Status: No, score=-7.02 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nic.cz
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 3rTKB-9GygmM for <netmod@ietfa.amsl.com>; Thu, 9 Mar 2017 03:42:04 -0800 (PST)
Received: from mail.nic.cz (mail.nic.cz [217.31.204.67]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 3FD55129437 for <netmod@ietf.org>; Thu, 9 Mar 2017 03:42:04 -0800 (PST)
Received: from [IPv6:2001:718:1a02:1:b460:39eb:a41b:3316] (unknown [IPv6:2001:718:1a02:1:b460:39eb:a41b:3316]) by mail.nic.cz (Postfix) with ESMTPSA id 3E4C360190; Thu, 9 Mar 2017 12:42:02 +0100 (CET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=nic.cz; s=default; t=1489059722; bh=IRq5f8E4GUNogkgByi7vC0uZcOGZTA/OopwVnemnrnw=; h=From:Date:To; b=gxmexjE8SJ2G6/ZCuYEOxvSqMvMCrdjcIx9TmxQxj1iC8lrzuP3EGL2r2NangckaT 7UxwXcvd4QWrsSaHnLRVC2GSrDyGFbgh+bXOXE6b0kSfi3R3QvEpYZ1aVX67isEmvT BUDioNq2nwEOwgnBOSxJ6GWeIdZ7J4pB3uHI+elI=
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 10.2 \(3259\))
From: Ladislav Lhotka <lhotka@nic.cz>
In-Reply-To: <20170308193434.GA10080@elstar.local>
Date: Thu, 9 Mar 2017 12:42:01 +0100
Content-Transfer-Encoding: quoted-printable
Message-Id: <6D5AAE1E-AC3B-4A6D-B33D-356052B08C64@nic.cz>
References: <EE43C03C-4660-4492-B40A-BAA17FD99A39@juniper.net> <20170303170233.GB3345@elstar.local> <20170307.185637.67261051570590747.mbj@tail-f.com> <82703e36-26f9-d459-c36a-c274861c5386@labn.net> <84583EEA-C7FE-4BB0-8D16-744E3768AB5C@nic.cz> <CABCOCHQaEAs039Tim6CWGg0h_cK1rcZo5DBS-Kko8j05UosZwQ@mail.gmail.com> <20170308180211.GA9937@elstar.local> <271CED23-8655-45A8-8E05-3ABD460871BD@juniper.net> <20170308193434.GA10080@elstar.local>
To: =?utf-8?B?SsO8cmdlbiBTY2jDtm53w6RsZGVy?= <j.schoenwaelder@jacobs-university.de>
X-Mailer: Apple Mail (2.3259)
X-Virus-Scanned: clamav-milter 0.99.2 at mail
X-Virus-Status: Clean
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/65pHEz170AlSVLa_aoeUFHAL1ks>
Cc: "netmod@ietf.org" <netmod@ietf.org>
Subject: Re: [netmod] stable reference for tree diagram notation
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.17
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: Thu, 09 Mar 2017 11:42:06 -0000

> On 8 Mar 2017, at 20:34, Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> wrote:
> 
> On Wed, Mar 08, 2017 at 06:56:20PM +0000, Kent Watsen wrote:
>> 
>> This way, reader can focus more quickly on the diffs, but also this
>> likely mimics what happened in reality (start with `pyang -f tree`
>> and then manually edit from there).  What do you think?
>> 
> 
> Manually edited tree diagrams? I hope not. Perhaps we should have text
> saying that tree diagrams are expected to be generated by tools and
> that they are expected to be consistent with the model (and hence they
> need to be updated with every change, hence usage of tools is a damn
> good idea).

Tools typically have options so even with their use the output needn't always be the same (for example, types and leafref pointers may be present or not).

Lada

> 
> [I thought this is obvious but perhaps this is not.]
> 
> /js
> 
> -- 
> Juergen Schoenwaelder           Jacobs University Bremen gGmbH
> Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
> Fax:   +49 421 200 3103         <http://www.jacobs-university.de/>
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod

--
Ladislav Lhotka, CZ.NIC Labs
PGP Key ID: 0xB8F92B08A9F76C67