Re: [netmod] stable reference for tree diagram notation

Kent Watsen <kwatsen@juniper.net> Wed, 08 March 2017 20:58 UTC

Return-Path: <kwatsen@juniper.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 A2D85129426 for <netmod@ietfa.amsl.com>; Wed, 8 Mar 2017 12:58:00 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.903
X-Spam-Level:
X-Spam-Status: No, score=-1.903 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=junipernetworks.onmicrosoft.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 vXjpxWdUiIED for <netmod@ietfa.amsl.com>; Wed, 8 Mar 2017 12:57:59 -0800 (PST)
Received: from NAM02-SN1-obe.outbound.protection.outlook.com (mail-sn1nam02on0113.outbound.protection.outlook.com [104.47.36.113]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8B729129404 for <netmod@ietf.org>; Wed, 8 Mar 2017 12:57:59 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=junipernetworks.onmicrosoft.com; s=selector1-juniper-net; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=va16I/yjjOVuALX6hv6nHQLsmpZGDl2KZcwXDGlOV6s=; b=gLHx3N4K7deILXuOyu0hcdjmQCtlEvKKfDJaO+DTAnuKjEwL/KT924+ylpav5DN6bJngAJjDm4SxuO4QytAwlpaGwUevenZOjytgdmozcQcMrFSfb7TUOZbJq7hu+veSMSkXrqAtg8Jlxz5BQcIj2ejEe3wW9k0DXgjg05oNeJo=
Received: from BN3PR0501MB1442.namprd05.prod.outlook.com (10.160.117.151) by BN3PR0501MB1441.namprd05.prod.outlook.com (10.160.117.150) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.961.8; Wed, 8 Mar 2017 20:57:58 +0000
Received: from BN3PR0501MB1442.namprd05.prod.outlook.com ([10.160.117.151]) by BN3PR0501MB1442.namprd05.prod.outlook.com ([10.160.117.151]) with mapi id 15.01.0961.012; Wed, 8 Mar 2017 20:57:58 +0000
From: Kent Watsen <kwatsen@juniper.net>
To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Thread-Topic: [netmod] stable reference for tree diagram notation
Thread-Index: AQHSlD0Kf+J5u9nqmEehA2iSQMJSUaGDV2yAgAZYboCAAWJqgIAAGpCAgAAJ9ACAAAz1gP//u06AgABeggD//8N6gA==
Date: Wed, 8 Mar 2017 20:57:58 +0000
Message-ID: <CE93FC76-634A-471B-B70C-7407B5B779E5@juniper.net>
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>
In-Reply-To: <20170308193434.GA10080@elstar.local>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/f.1f.0.170216
authentication-results: jacobs-university.de; dkim=none (message not signed) header.d=none;jacobs-university.de; dmarc=none action=none header.from=juniper.net;
x-ms-exchange-messagesentrepresentingtype: 1
x-originating-ip: [66.129.241.13]
x-microsoft-exchange-diagnostics: 1; BN3PR0501MB1441; 7:bJqNY3lj2c0caOBeIU6YK4Qsf7Mmq3ys3A8X0YqHnxensImNrL7O2h4GsuqwaDLS18JzrJCNoQEaeJTbaV/Q7C06l5eZSiTC8TiWGqJYvEZQbrChXkcTI4mzqqRM1f8Nhj6jA08zfy+CPtgRJIlT77UHOOnBrdZl6/cH0sApDXjXtF31QlrjQPkjOdXwQqMj5iatInZSgUe6lai7ufnGV0Q1Fa8kuIk5MHgPIeSh0pL/e6KJklrox7vHp2YU/mI7SF0fORQ0j630UNQc2yeEIXi9aBpwXpTmKuXQ7Ehycy+orM3A92NdBz/qr2dVZv4a1x7wzEvFknoAWmmoAC9fvg==
x-ms-office365-filtering-correlation-id: c0b5aa20-6d8e-44c3-5a65-08d46665cd29
x-ms-office365-filtering-ht: Tenant
x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081); SRVR:BN3PR0501MB1441;
x-microsoft-antispam-prvs: <BN3PR0501MB1441C1D6FFE5C2590313152CA52E0@BN3PR0501MB1441.namprd05.prod.outlook.com>
x-exchange-antispam-report-test: UriScan:;
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(5005006)(8121501046)(3002001)(10201501046)(6055026)(6041248)(20161123564025)(20161123555025)(20161123560025)(20161123562025)(20161123558025)(6072148); SRVR:BN3PR0501MB1441; BCL:0; PCL:0; RULEID:; SRVR:BN3PR0501MB1441;
x-forefront-prvs: 02408926C4
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(6009001)(39450400003)(39840400002)(39860400002)(39850400002)(39410400002)(76104003)(305945005)(6116002)(8676002)(102836003)(8936002)(93886004)(122556002)(81166006)(106116001)(50986999)(54356999)(33656002)(3846002)(3280700002)(76176999)(86362001)(5660300001)(77096006)(189998001)(3660700001)(6916009)(2906002)(66066001)(7736002)(110136004)(36756003)(83716003)(6246003)(4326008)(53936002)(82746002)(99286003)(25786008)(229853002)(6506006)(6436002)(83506001)(6486002)(54906002)(38730400002)(2900100001)(2950100002)(6512007)(104396002); DIR:OUT; SFP:1102; SCL:1; SRVR:BN3PR0501MB1441; H:BN3PR0501MB1442.namprd05.prod.outlook.com; FPR:; SPF:None; MLV:sfv; LANG:en;
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: text/plain; charset="utf-8"
Content-ID: <A643DB4BF47DA94EA672BFF4D8B2695A@namprd05.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: juniper.net
X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Mar 2017 20:57:58.4445 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: bea78b3c-4cdb-4130-854a-1d193232e5f4
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR0501MB1441
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/iRodmgs8aBPLGTn2RHJ5QsA8jdo>
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: Wed, 08 Mar 2017 20:58:00 -0000



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


Right, but what happens when the draft precedes the tool being
updated (e.g., schema-mount)?  It's a rare case and you already
said authors can address it on a case-by-case basis, so I think
we're covered either way.

K.