Re: [netmod] stable reference for tree diagram notation

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Wed, 08 March 2017 19:34 UTC

Return-Path: <j.schoenwaelder@jacobs-university.de>
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 AE8EC129551 for <netmod@ietfa.amsl.com>; Wed, 8 Mar 2017 11:34:32 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.201
X-Spam-Level:
X-Spam-Status: No, score=-4.201 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RP_MATCHES_RCVD=-0.001] autolearn=ham autolearn_force=no
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 qrvPvoIWpI8H for <netmod@ietfa.amsl.com>; Wed, 8 Mar 2017 11:34:31 -0800 (PST)
Received: from atlas3.jacobs-university.de (atlas3.jacobs-university.de [212.201.44.18]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 7A5C41293FF for <netmod@ietf.org>; Wed, 8 Mar 2017 11:34:31 -0800 (PST)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas3.jacobs-university.de (Postfix) with ESMTP id 4D4EB15D3; Wed, 8 Mar 2017 20:34:30 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas3.jacobs-university.de ([10.70.0.205]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10030) with ESMTP id xVvmqFLn_i1Q; Wed, 8 Mar 2017 20:34:29 +0100 (CET)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hermes.jacobs-university.de", Issuer "Jacobs University CA - G01" (verified OK)) by atlas3.jacobs-university.de (Postfix) with ESMTPS; Wed, 8 Mar 2017 20:34:30 +0100 (CET)
Received: from localhost (demetrius3.jacobs-university.de [212.201.44.48]) by hermes.jacobs-university.de (Postfix) with ESMTP id 0F0CD20039; Wed, 8 Mar 2017 20:34:30 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius3.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id Auhv6fQNsPz9; Wed, 8 Mar 2017 20:34:29 +0100 (CET)
Received: from elstar.local (elstar.jacobs.jacobs-university.de [10.50.231.133]) by hermes.jacobs-university.de (Postfix) with ESMTP id A9D5420035; Wed, 8 Mar 2017 20:34:29 +0100 (CET)
Received: by elstar.local (Postfix, from userid 501) id 146A83E9C3DF; Wed, 8 Mar 2017 20:34:34 +0100 (CET)
Date: Wed, 8 Mar 2017 20:34:34 +0100
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Kent Watsen <kwatsen@juniper.net>
Message-ID: <20170308193434.GA10080@elstar.local>
Mail-Followup-To: Kent Watsen <kwatsen@juniper.net>, Andy Bierman <andy@yumaworks.com>, "netmod@ietf.org" <netmod@ietf.org>
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>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <271CED23-8655-45A8-8E05-3ABD460871BD@juniper.net>
User-Agent: Mutt/1.6.0 (2016-04-01)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/5roVPHTINksxMz8nA86e9fIfSLs>
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
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
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: Wed, 08 Mar 2017 19:34:32 -0000

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).

[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/>