Re: [netmod] stable reference for tree diagram notation

Kent Watsen <kwatsen@juniper.net> Wed, 08 March 2017 18:56 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 6A7D6129487 for <netmod@ietfa.amsl.com>; Wed, 8 Mar 2017 10:56:23 -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 5FsHmG4N4-jd for <netmod@ietfa.amsl.com>; Wed, 8 Mar 2017 10:56:22 -0800 (PST)
Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0105.outbound.protection.outlook.com [104.47.42.105]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E257E128AB0 for <netmod@ietf.org>; Wed, 8 Mar 2017 10:56:21 -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=rnNQeZOU0xpdu3RJT1Ep0lfiamHsaLAWAtawkvZS+xQ=; b=NOi7gvXV+YqAOEoZPpS8UEAllRoCo/4N7+U6dKiXBhGw4b7JhepqUieo2EfUxHOYmEfaieiB4KqfG7n4hmuxDC5D990lbNWUTPIwoOt49B/GJJexOUo/Rqiziabl8IsmPnmAY1aWocbHsivKLyUcTuP+t22XyBpNQ04zkMAH3K8=
Received: from BN3PR0501MB1442.namprd05.prod.outlook.com (10.160.117.151) by BN3PR0501MB1442.namprd05.prod.outlook.com (10.160.117.151) 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 18:56:20 +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 18:56:20 +0000
From: Kent Watsen <kwatsen@juniper.net>
To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>, Andy Bierman <andy@yumaworks.com>
Thread-Topic: [netmod] stable reference for tree diagram notation
Thread-Index: AQHSlD0Kf+J5u9nqmEehA2iSQMJSUaGDV2yAgAZYboCAAWJqgIAAGpCAgAAJ9ACAAAz1gP//u06A
Date: Wed, 8 Mar 2017 18:56:20 +0000
Message-ID: <271CED23-8655-45A8-8E05-3ABD460871BD@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>
In-Reply-To: <20170308180211.GA9937@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; BN3PR0501MB1442; 7:4e9dvWtGde0/Yn6IGmbqU87A386L+FL2Se8Gr9KTOnNyjqpxbuMz2+IRysb48VIeypfAp3nRro3bzQid+l+Kx7flrJHXtYR8xMDvMLjUlRJxYfAZPt7FomMxoHGjnT4hy+MBdUG0Tnyiwp8mfjrYxNbZJyZm574p4JK5XvqwXosO2ZJSS+dVR6pqXA2TKv3kG7XEXgXk+PPCmDfQqei/6MUAsbDibkWWTxBly5KcF6pqEeu79Ec/HG08yvUxpU6XcblczvrvrTc2DDoMRHxOG9a9sFF1YZqthj0eSjjbNDlK8HqTXOCbbK939BoZUCzrQVv8/bixlmI/e+yNdmQujg==
x-ms-office365-filtering-correlation-id: d81b417d-954c-4cd6-ed92-08d46654cf6f
x-ms-office365-filtering-ht: Tenant
x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081); SRVR:BN3PR0501MB1442;
x-microsoft-antispam-prvs: <BN3PR0501MB14427C706190FA757F401555A52E0@BN3PR0501MB1442.namprd05.prod.outlook.com>
x-exchange-antispam-report-test: UriScan:;
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(6055026)(6041248)(20161123558025)(20161123564025)(20161123555025)(20161123562025)(20161123560025)(6072148); SRVR:BN3PR0501MB1442; BCL:0; PCL:0; RULEID:; SRVR:BN3PR0501MB1442;
x-forefront-prvs: 02408926C4
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(6009001)(39450400003)(39850400002)(39410400002)(39840400002)(39860400002)(76104003)(38730400002)(3280700002)(2906002)(54356999)(6246003)(82746002)(229853002)(83506001)(3660700001)(33656002)(76176999)(4326008)(7736002)(50986999)(106116001)(3846002)(122556002)(305945005)(6506006)(6436002)(86362001)(77096006)(102836003)(6512007)(25786008)(53936002)(99286003)(5660300001)(83716003)(66066001)(93886004)(2950100002)(36756003)(6486002)(8936002)(81166006)(2900100001)(8676002)(189998001)(6116002)(104396002); DIR:OUT; SFP:1102; SCL:1; SRVR:BN3PR0501MB1442; 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: <99091CC31519FB43B70705641BE090CD@namprd05.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: juniper.net
X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Mar 2017 18:56:20.8337 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: bea78b3c-4cdb-4130-854a-1d193232e5f4
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR0501MB1442
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/R-dPcRcVuId_NBI_cQpKCn9gi0w>
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 18:56:23 -0000



> I think we can allow both and leave it to the document author. Either
> the author uses a well known tree format and refers to its definition
> or the author uses a not yet well known tree format and then it has
> to be defined inline:

Nice compromise, but even then it would be helpful if a draft that wants
to use some custom-annotations do so on top of a standard tree-diagram.
So, for instance, the draft might say something like:

  Tree diagrams used in this draft use notation described in
  [RFCXXXX] with the following additional annotations:

     @ - means ...
     # - means ...
     etc.

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?

K.