IETF Logo Mail Archive

Re: [netmod] WGLC - draft-ietf-netmod-yang-tree-diagrams

"t.petch" <ietfc@btconnect.com> Sat, 13 January 2018 13:04 UTC

Return-Path: <ietfc@btconnect.com>
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 56502129515; Sat, 13 Jan 2018 05:04:23 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: 0
X-Spam-Level:
X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-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=btconnect.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 nje5aAy_SmNH; Sat, 13 Jan 2018 05:04:21 -0800 (PST)
Received: from EUR03-DB5-obe.outbound.protection.outlook.com (mail-db5eur03on0730.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe0a::730]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 0D075127136; Sat, 13 Jan 2018 05:04:20 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=btconnect.onmicrosoft.com; s=selector1-btconnect-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=Xsjk3nV5MY25/qOKUaV7viwSoENTGXlQbrrZyC/BRec=; b=h80i1iOWgdl9ut27XAVUES45ToskoT82js1f2ewm6T8IPLNj+uP9/OmsW0eQ+ODE65vj7dCf/NWsg6nZEVz8AXsPy5X4UJAb2EP4VFktNaO/f6ckG79Q11LOX4rWgWpL3iQP7tzFXYTBPU/HW0sQcnra2VG29wBWWiSwkbaS/0I=
Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=ietfc@btconnect.com;
Received: from pc6 (86.169.153.236) by DB6PR0701MB2997.eurprd07.prod.outlook.com (2603:10a6:4:73::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.428.9; Sat, 13 Jan 2018 13:04:18 +0000
Message-ID: <022301d38c6e$e2f0cf00$4001a8c0@gateway.2wire.net>
From: "t.petch" <ietfc@btconnect.com>
To: NETMOD Working Group <netmod@ietf.org>, joel jaeggli <joelja@bogus.com>
Cc: draft-ietf-netmod-yang-tree-diagrams@ietf.org
References: <2cde8b64-0455-a513-4719-feb61c87a952@bogus.com>
Date: Sat, 13 Jan 2018 13:00:19 -0000
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2800.1106
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106
X-Originating-IP: [86.169.153.236]
X-ClientProxiedBy: HE1PR0502CA0008.eurprd05.prod.outlook.com (2603:10a6:3:e3::18) To DB6PR0701MB2997.eurprd07.prod.outlook.com (2603:10a6:4:73::7)
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: 57936015-bf17-4abc-8315-08d55a862818
X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(8989060)(4534125)(4602075)(4627221)(201703031133081)(201702281549075)(8990040)(5600026)(4604075)(2017052603307)(7193020); SRVR:DB6PR0701MB2997;
X-Microsoft-Exchange-Diagnostics: 1; DB6PR0701MB2997; 3:ewUIUL8npgyP/sYxZbJS1fGI/MMsqRPXmi/zBmZ6HKyHsUfgZXxPTpjYVusA/RrifN5RZAvc/tzEHX0qIQQPWSpYu3Fq5wy0kAoYp+opkBwa7S/biKUO7BAgfQJYPMFcz2708mx8i1E3QvulDkEOocuMjlHssOpBjgSWoCqwVTGDFD0ERubBKRMRa5+DSQgA3O+GUXyEVWfsEjwuZLofH+NaKyVxacZK5j0+OkkKd1GOvxBRkIw8Kw0zHe8skURU; 25:O0wMe2C7XLjGNxVbOLlhn2fC6u2oChce6/j2I7XCC0vqq/V+ARijmzbmSgKXziZYVlAA4TO9F7LwP9c/vAF9pM128hcxKTUZ1Ono4DGdC6LGVFjgIHBc9/HRl2eC7w0Uj/j/kTCkvC7NxqHRwANc0Av8tbgAnJ9oQZZW274tYRLXnqwWxht6OcSCW49zD9QGrfPwQ+mxB7/Lw4jOMCFFn4c8jw+OgO52D8Q/8c80gg3YVfvaAHtFg3m7B7jOQqPn9mdMJ/Ctfd/6jy6m80GnX2MXkonk1VtmMVYQNY9Qvny5BzxSEd6lJvOqgo4Uv6Qw2gdwAkKgO0qK4pYYQqvxkA==; 31:JLiqfbntA111x9Wb6D3Lhm7XWErZ65Wvl0SA5fpTKcob/2z7OjMeqlkwHWS855gRTYvtiv3srrZY3gnv7tlNOdehUE4EwRN/zyeT0Z713+0c1MPTGucuWOaFzpox/sDwRM67F8rtEcPLTtFzHT9pqpiSGQu2rZMW3pxR6NtcfTK+CsSkwdqJ5Xhgot6g90j6gvtgYnn8r+XEN2nGO/h4t6ukFNpcDODb11gzJX3z7Zg=
X-MS-TrafficTypeDiagnostic: DB6PR0701MB2997:
X-Microsoft-Antispam-PRVS: <DB6PR0701MB29976F73523C6EEBD9707E92A0140@DB6PR0701MB2997.eurprd07.prod.outlook.com>
X-Exchange-Antispam-Report-Test: UriScan:(120809045254105);
X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(61425038)(6040470)(2401047)(5005006)(8121501046)(3231023)(944501075)(10201501046)(93006095)(93001095)(3002001)(6055026)(61426038)(61427038)(6041268)(20161123558120)(20161123562045)(20161123564045)(20161123560045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(6072148)(201708071742011); SRVR:DB6PR0701MB2997; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:DB6PR0701MB2997;
X-Microsoft-Exchange-Diagnostics: 1; DB6PR0701MB2997; 4:s1xeD6IeZxRnzSdEWKPI9U4s7zKNp/P4RZd8tKpUU6di/27aR5QSCZoGNUbMCXzigNVP0p9g3JAeX+4lEsL/5bxAzdu43fG7FzS0zhNBVXcCSTqdeSRaKgWoCNMHJoOVcjeNYni3ea/fzaNkyOHQ3hy7suhBYcrm/Pk7aqr8i9paq73nowDyfxRHMDg6qA0GEiqqwont/Dvb73wvLuxaI2tSW27WAEGC2C5g4zzt9F/Qlb/CbGMdPciBTBsPl1fOxC5MEQhQwwFoHkHc+FdS+gE+0P9SCXrp2x+71T4WxpAwqdGwoHVBnWgY1qu6ame2
X-Forefront-PRVS: 05514B7026
X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(366004)(376002)(39860400002)(39380400002)(346002)(396003)(189003)(199004)(51444003)(13464003)(61296003)(44736005)(1556002)(86362001)(106356001)(105586002)(50466002)(14496001)(230783001)(478600001)(966005)(2906002)(3846002)(6116002)(84392002)(6486002)(7736002)(230700001)(6306002)(9686003)(97736004)(305945005)(53936002)(316002)(110136005)(8676002)(229853002)(16526018)(47776003)(66066001)(62236002)(44716002)(68736007)(1456003)(8936002)(4326008)(50226002)(81156014)(81166006)(6246003)(386003)(5660300001)(4720700003)(25786009)(23676004)(81686011)(76176011)(59450400001)(2486003)(52116002)(6496006)(33896004)(81816011)(74416001)(7726001); DIR:OUT; SFP:1102; SCL:1; SRVR:DB6PR0701MB2997; H:pc6; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:0; LANG:en;
Received-SPF: None (protection.outlook.com: btconnect.com does not designate permitted sender hosts)
X-Microsoft-Exchange-Diagnostics: 1;DB6PR0701MB2997;23:uwmqTbhCmq2w9XcO7zS2i7oXR8GVELazy6ezNUOAo/7CwcB0+aLKqZwlnRslA14g4TfmNYK2jdZxCYmqsuy3NUp5PCXSQRUwjbhwxlgn7X3Ru5+TtuCX6yF7NgPzsZO0Yslf87QR9E+gxDJFPhAWPnK4hFdnbVzsUAGPWNMiDybHVujELDg4NjiSTcPIC4wDhqwC4rtcYP/Lkh+HufCusnVIXLVKynJAAy5r1NhBYzUNTfsY1lDx7r/TCOJTLseVkQY29ikEdNMiOjDtpMztgJgZiYMYK/oNWkT2UXlhaOAFMAuuX/bM/zqEE7UT01khKaiNvSBe6FMzDOSZRk6Ft5vLjsnOZD+r6HDtNyGvF7Cpo7TbwMlRaT44vpTLtCzS8oCGPLsbMKGMFhxp/cUHgqXRhlxcydiBqtQtPLcyQv9Uhfh4WYYfCCYin4oftLhTPbNw/JB13up7XJZ5CyMgbmxbXlnd+7/ssq7zc4lyWxUwlQ21WGxo/eNOfHceKRFWTs29aZdjio0tJUcn7k9iJlKUORiVxXV3RMdQywtojiQ6qhTWPru+INEc4TKfOPQ4RR+vrHT/1jHK4mC3d27/12CRt+P6Kgp0GPkRkSsNhEpBPQ/1p3N5yUvj1AIzk2+0RZXDeq29PwOKvle+T5NQDIStRHfWmz6+fLklZPCcRjH81Nu0S99uSdw5OdAgnL1V3cfWYB6i0/RmNiff3F6RILk9FB7wPti5Fesq7jabXaUQI86uCHPyVlfHgqpjnLcvpWeiJ6yb9HvZ9o4mOsWk3hTfH8T8PAm/bQ6FObHpV8UcRjGAIWRe17mzATOUtfHRkjyZxvfbUAIl6MbLkLX85F6o+ygs0My4W6dknqf3LqHU3w/FCDyT6493zd1uWxgTVjmmZ0EgQmAw6vxEmKCSog8ifJUN8Wl/LiqOtmHtmoJjUfYIhQ6Wpd02xmD0Mxfrs30Qa7psji+dbwTyz0nCBnY1xpKjchDiNAgF1QCdYyO3rUfL7d1TtuuSwRh7VrLtMOuIV+veVUoJJd5hJjexM5yaVu07cGjtAh3J9B9yH/JRFwvfHXKRFFq4y3OWy6S0LHW4ffN6X+vt/BPEEASNsa+WOD8uIRtWImmAP5Rc6sXrr/Wkzyvvwg9J9s7QGSldL0qiCreC1ajnKCXAFd0opGWoSMtu3VfA87k6DqAUA6B5teUeDIS24ZoKoZ7fZVUjsUwdnmlDfyYDiyCvi8nV+8JldK5RcdqCWwBkDZAsmv/Qp7L4/F8ehvR+My8qik8clV7givEo21X9RfHk83YwGuJmMyKTeRjDE4+W/ybvkbRVUCOoxenSNsdGML4G9I6j4OmfU2wVCH382hfHfesgh3IKFpkb0IhTmN7z+iNX4HbB2dVZjVtK6S2onPE+aS8M+UWuGo5uKuR6qLdKmuRdJ4lLttKiknXY+b/DZ8xaGiIoYD39kccrzRJKpPwwKZp6
X-Microsoft-Exchange-Diagnostics: 1; DB6PR0701MB2997; 6:idAbaRFcPrLfo6it4y6Y2tGTNYbJBci08oWZ7WAR9PqXG45C2Hq4BDKhzv7e7Mqxwdv8eWSeKilXevT2RVTg1AjzfdO9FEkL3iE78L50ErqyTDxw+UYVB2h78yqVfO4SqnzNonXqCqDAebZr0VdjLF6pXi/YAzBhvVUzn9g5wxpADYypKa5rF3vzLl/+cOJNMAm7Ixd18Fmj92P6P9WsrYiTAoTuOer0mJv2RrfN1ZNaW58uIJOQC3M2ANtOCh+4HFyshVQ+zcDfl9RYYJmsDccu4N3HZp+rOy3MUY8gQVdvfjkvYueASz4LEmFu1ppszR3n0YNxsMVmK6O94GIv1/tchGZrmEhElmh2nAFAqDc=; 5:QsDBcpLQkltlWdWXrqL6fyRkh/RyJ01tG4fitw7kCCEcdQ9/ww3z3MThLQAK8z6iuNP5QsHm48GMSTeeJe4QIvlTQiJXaqPu4OJTOlrQzF5HpmHMxE6E33uFtx8ME1PbE71n0GSwJ5LcTA6QSfhEp+xu5+wrq2aoKdDJKcwGZTc=; 24:NXwa9Kbiadu59Ez/Kxya9cmuM6M0cvvWax7x8vsy754onWiSOhZ6vPWTK8ggmlihZByfjOO6Jx9lh/gQ8L9NTJFTjYQ7k2JeBRsLd6bs/ZM=; 7:ar1n4N6Xr5AjopVazbMhaaiHE0HQQgQRZ8CKvaHVqu530S4CI4Ykr/23CwcOFZTyMP2PvdF01mMzVJ3B9jiVhzXQPBe28wkn1saJhKtc+IMvpJelE1z30Nt1pEdtaiTZXz2KSEIY1yr1CLsTXunNs3BOVRjI25m5WXjdd2xsIUbolLwnWOPQB1zvfRiXO1dTR0jFWXIuBrRvf9XrZb4KPby+zDkatGmlzlbBjvyaCd2b9Fkcz7goUcuTEoqXiDZi
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jan 2018 13:04:18.1668 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 57936015-bf17-4abc-8315-08d55a862818
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: cf8853ed-96e5-465b-9185-806bfe185e30
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0701MB2997
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/VaQcmwHENquxzQ03V7z8qRWSsxc>
Subject: Re: [netmod] WGLC - draft-ietf-netmod-yang-tree-diagrams
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
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: Sat, 13 Jan 2018 13:04:23 -0000

I think that the outstanding issue is what to do with long tree
diagrams. Yes, we have discussed it and have a statement about one page
being a good idea but very few of the I-Ds I see can manage that.

RIP has four pages, NAT has six.  OSPF and BFD have divided the diagram
up but many if not most of the subdivisions still exceed one page (I
would regard two as more or less ok but many exceed that).

My own take is that a too long tree diagram reflects a too flat module
structure, just as many years ago, code would be a long unbroken
sequence and now is divided up into manageable modules, so a YANG module
should be structured as smaller pieces, bite-size chunks, and a tree
diagram of one page is a good indicator of a manageable chunk size.

Tom Petch

----- Original Message -----
From: "joel jaeggli" <joelja@bogus.com>
Sent: Monday, January 01, 2018 10:01 PM

Greetings,

We hope  the new year is a time to make great progess on outstanding
documents before preparation for the  London IETF begins in earnest.

This starts a two-week working group last call on:

 YANG Tree Diagrams
draft-ietf-netmod-yang-tree-diagrams

https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-tree-diagrams/

Please send email to the list indicating your support or concerns.

We are particularly interested in statements of the form:

  * I have reviewed this draft and found no issues.
  * I have reviewed this draft and found the following issues: ...


Thank you,
NETMOD WG Chairs







------------------------------------------------------------------------
--------


> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod
>

v2.23.0 | Report a Bug | By Email