Re: [netmod] I-D Action: draft-ietf-netmod-yang-tree-diagrams-02.txt size

"t.petch" <ietfc@btconnect.com> Fri, 27 October 2017 11:12 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 7468513F4F0 for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 04:12:49 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.701
X-Spam-Level:
X-Spam-Status: No, score=-4.701 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=-2.8, SPF_PASS=-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 zx9f7lgO8BsV for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 04:12:47 -0700 (PDT)
Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-ve1eur01on0136.outbound.protection.outlook.com [104.47.1.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A346013F4F4 for <netmod@ietf.org>; Fri, 27 Oct 2017 04:12:46 -0700 (PDT)
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=yK5ikzbdl/yHtZQd5Ol+fPXMXybsG1MKcoqDNIlxnMA=; b=imAnM8KrDx5NW+mfOe5P99e+tjfUcwsESh8nB+H/2ObTBzHFl9l1QZSJpp5VV/pk28d1vvzVON0j/aU/eiY9DkqxgNzlyreCnDelvSSq50a5wb8+tdoSLcDuLKRdEoONUVFH6YAL7E433CShiiB4kdSGYAlDMGY9H7q0ePyKG5A=
Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=ietfc@btconnect.com;
Received: from pc6 (86.169.153.236) by AM5PR0701MB2995.eurprd07.prod.outlook.com (2603:10a6:203:48::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.178.3; Fri, 27 Oct 2017 11:12:44 +0000
Message-ID: <03bc01d34f14$29850500$4001a8c0@gateway.2wire.net>
From: "t.petch" <ietfc@btconnect.com>
To: "Mahesh Jethanandani" <mjethanandani@gmail.com>
Cc: <netmod@ietf.org>, "Lou Berger" <lberger@labn.net>
References: <150893578927.4882.2117597388624976982@ietfa.amsl.com> <23892572-a0db-d24b-e591-a19799ace9ae@labn.net> <010301d34e7b$1d5303c0$4001a8c0@gateway.2wire.net> <122E6B31-38CA-47DD-8891-A79D3BC8BCC7@gmail.com>
Date: Fri, 27 Oct 2017 12:10:03 +0100
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
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: DB6P189CA0008.EURP189.PROD.OUTLOOK.COM (2603:10a6:6:2e::21) To AM5PR0701MB2995.eurprd07.prod.outlook.com (2603:10a6:203:48::17)
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: d64e3a5b-3359-47dc-7400-08d51d2ba5ca
X-Microsoft-Antispam: UriScan:(178726229863574); BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627075)(201703031133081)(201702281549075)(2017052603199); SRVR:AM5PR0701MB2995;
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2995; 3:6Kbu+0bxPCfvIIw8mwNFm9XdF2aDXy45jiIEoPxxgr/0T9d0HVAq5nK67g35a3QflgkjwzfnBBomRbdHzAH7bbo6wlNDW/Jw+By0j495l3uSf3qnpnQx41cU4ymVXLwq2gkIB4cUHmBZWQeHnLrgShmqQrhTPcoKdltUrQYb8mr/VyTaAXpAI8UYTwxmAniZHlvDgabSPiTKRBST9YIomZHgGbCV/mZaZrDX6c4ZU6Q0RXN/dVPjILl+3upcWCdM3eN0Vj0tqRWdMbgu1kpW1+WzmLc2sSueHV0uWT9EUuE=; 25:26EUjR2QBWNgipgsxkmtzr245jWJvRVZIyv+59ycb4/1KzP+MghBZXo1w5jrzUs4Jcfw/LGRe6hsaiDVSnRCQzeuCJ/DEp5as7+tD5JyElvvk5/wwdWYIMrbl2xxDqImWvBCvTAM+gkaNpX9Rby+pMiYFNxwvfnNztAVMzhq2dEBKEFFapgUuwk63TiB6eLTVOxaFj4yNpeDBCcVO/HbS95ykWNtlfvhzobCwAUM61YItnMpItWKI3O6fm+Y0f6PBBQVLVKKP2I2s2JOzH03SDxjl2ZvuW0/sEmPH9OPqL0oaTpsozgqiAJ8K41av0br8H75WYcOP5wKhpc1sxDxgg==; 31:O1qqUypvmHJA/yMy5tVy+D2EKET8dsBqR3Z6akhk34qz6hTaRIFWz4ymVvw/ESh8smnABNdmM0GlJVt7T76fKfTm/HO0C7q82xaqTq6hIifP2Ldwf2FJTlM3qdQvNC5CalWzIjhYQeZM367Ewin0Vcotw8nhk/jkz3Yd9yyxzxFu06Iw7coyOfBZjC9YxPvBw+RvtV6bqzzvz3pdDwGeTmEbVMjbK64/I5IQS1he3e0=
X-MS-TrafficTypeDiagnostic: AM5PR0701MB2995:
X-Exchange-Antispam-Report-Test: UriScan:(178726229863574)(192374486261705);
X-Microsoft-Antispam-PRVS: <AM5PR0701MB299528A3A3BECD4BD2C25AD7A05A0@AM5PR0701MB2995.eurprd07.prod.outlook.com>
X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(61425038)(6040450)(2401047)(8121501046)(5005006)(3002001)(10201501046)(93006095)(93001095)(3231020)(100000703101)(100105400095)(61426038)(61427038)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(20161123562025)(20161123555025)(20161123560025)(20161123564025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:AM5PR0701MB2995; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:AM5PR0701MB2995;
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2995; 4:5xLxyn4IxIZAVXDnR9yJrn24lNIzP6/2/t2NfCxFWdssT2LnNSbACv/KYZifgy4M/vgCD0JYPbC+mYEsV17Ep6Zbrpyh5BErJ/Ui/npamuoM/kFY7Qmaf8Orx1GJJNRoZCA9T08YBuTp1RafhGh/TmEsvUoRe6a/6zS7qp3nAsfKdGQZa/MP3z9czPQ+MGYQQUbh2R/HvkCcqsEQV/JZsfFJQH3BWpx/qPAlEdVzhp9PY6eG/lMgeB+MGkr3o0/zOBF0WZdnikSC47UHd1dxUOT2pprDXvdwcN20N4xB9dVYAVT8ZrcHIs2/q3kKwcBoExD80u66cgT9BX37SeVMuxEVe7rGIUnayBJcObUKYjk=
X-Forefront-PRVS: 0473A03F3F
X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(6009001)(346002)(376002)(39860400002)(51444003)(189002)(24454002)(199003)(377424004)(13464003)(4326008)(2906002)(68736007)(6246003)(4001150100001)(966005)(8676002)(1456003)(1556002)(44736005)(50226002)(4720700003)(2870700001)(61296003)(81816999)(81686999)(54906003)(76176999)(50986999)(229853002)(6496005)(53936002)(6486002)(97736004)(316002)(1411001)(101416001)(39060400002)(50466002)(25786009)(478600001)(84392002)(6666003)(53546010)(5660300001)(116806002)(105586002)(7736002)(62236002)(8936002)(44716002)(106356001)(47776003)(305945005)(66066001)(6916009)(16526018)(23676002)(6306002)(93886005)(189998001)(81156014)(81166006)(9686003)(230783001)(3846002)(6116002)(33646002)(14496001)(86362001)(74416001)(7726001); DIR:OUT; SFP:1102; SCL:1; SRVR:AM5PR0701MB2995; 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: =?utf-8?B?MTtBTTVQUjA3MDFNQjI5OTU7MjM6TW5SUGhuN1FxWTlxRGRPNU5EMlV4Tm5E?= =?utf-8?B?YloxRTJzL0JoMWprODJiMHNvblFLa0RYZDdqYzRhcUJwcE45K2JHYVA2UmJ2?= =?utf-8?B?VkVQdEJZSXQ4U1lKV3JMOU9WRFE2T1IvK0EyUnJrL3JJSDlRN3NBelpVZ3Vm?= =?utf-8?B?Umwrb2JJWW1rcW45REtjZEwxdzdRZ2w5VU11YXJIc01iOXh4ZnNXdW5MZVcw?= =?utf-8?B?Tm1HYjR1L3dOWlAvR29paFF5K2w0Mm10SnBQdnR4eXpzTXZRNkptUGtIWGRm?= =?utf-8?B?REJCN0R2K1ptMXlPd3MweGVNS01QdHBYYmZLT0dObjk1dUVRZVRGMnZPUWRK?= =?utf-8?B?cXF6bUJVVEpTU09QZDJLdFdtUFNYUytjVnI1OWxNM0JSNHQ2dXQ4MHlBT202?= =?utf-8?B?MVVXazdYVGFCSnNhb01tcjZKTEZucEozTTZvbUk2alNaaHd2L25nVEY3cm1l?= =?utf-8?B?cS9JZmpmbFpMUmdsN2VPdlVrM0t1ZVJDRmFZdzRyZE5aa3VmWisyQnVRaFlr?= =?utf-8?B?WEd4MHNHMWY2QXNQV0UwWlJlaC8ybVdRSnhBUFJ1VVlWMVozQVI0WCswQ0Zq?= =?utf-8?B?MlcvS2JJVGhtenNJcG9xdjI4QkJIOXNzdmYzaHhnMXdnUThtdE12Ym96NFRo?= =?utf-8?B?cGVDRk1UUFBNK29JYTNjMnNiOGFPV1BpOTM1Z1RibEtONXJYM210WXFjdXhI?= =?utf-8?B?TnJJdjBPc3ZxYlRXWXlMdG1qYitueXVLOHpoS3d3UnNpTDU1eUxMN2tqa3h6?= =?utf-8?B?YTNCQ2Vnd3N2OE1qWkJ1MmNOWDd0TmFoaUo0enpPL2ROUFQxdTFrZmFUeXMx?= =?utf-8?B?Qjh2S2xpNjFXWUJyVkd5QWNKbXN5ZmdCVHBHYUxuRitwQU1tMzdCMngwazFL?= =?utf-8?B?MlRnU3BEN0pScWo3ZWMyelYra3NvTmp4SmI4YlUzK045eS9GVUxXVFdqNUFS?= =?utf-8?B?eWRxaEh0dGh0OGc0elNQbGg1WFNGbDU0OEIyYzJKNjVkM0ZIM0FNUlhwbHVl?= =?utf-8?B?YVkwRktld3MvajhKT2NRWGZvb09Ccno2UWlPd2NEUEpwbFR4cWxPOEszbXBF?= =?utf-8?B?QXVnQW1CZEVJbGpSYWEwWE1XODk0NzRPL2F2QVBJdktML1FVNkNBZnBBbzR6?= =?utf-8?B?UkNuV2NtU0I3OFRKbHU3OWg4Q3lvS0Y2UkpZbnBZY0NvUUxGbXFyQnZwRU5i?= =?utf-8?B?dGg4K3NZYkhab2hRMFRUa1BIMUlHVTJrdU44WkJLZkRVc3FPQkpud0J1ckdN?= =?utf-8?B?UFVYT1M0cUgwZUJRKzczQkphN0pWTlhNelErS1VvUGNSWmJQaHJrOVBBSHlZ?= =?utf-8?B?THBhQnE1cUlLYkc3SWEvUkJJRWRsdzFYS25XSE81dEt1VTdlc3d4NjRqdk10?= =?utf-8?B?b2JtSlpEMEd0a2l4a2I3bzlpdXRPbTZiNm1jN0FqZmVHdWQ3SFhaSE1zMW1i?= =?utf-8?B?M25zN2xVT2NCUm5vdjY2SUExcms0ZzlXb2xiQXRTem1mWkhqR2RIYTk0TWZ1?= =?utf-8?B?ODl3K1FPQ0hoVWdzcUoxbDQrOVpTM0t4c2FxaElHNHplOTBLTlBPd0VxTUM2?= =?utf-8?B?LzJxVVp2Nm5oVitzQS9TdVd3TkltRHNjS3JBTGpCMSs4c3FhdlhwRVFqR1Ra?= =?utf-8?B?S1RDUXdEL01hSjJINkRyVnRNZzBSQ05DSC85OTZ6R1pnYkY3aFdHa2EwN3BL?= =?utf-8?B?V05CWklKeG9ucWduQnZ0MDJpNzViVExUb1gvYmwreFNlQVd6czBxWUZaLzB0?= =?utf-8?B?aXRyV2Q4TkEvWDJwT2Y4ejBXYWpzUUNJbmtTWHE4L0svOGIxYjd2T205TjNG?= =?utf-8?B?dUJJVHJBSTl3NFM5bGJMOTYveTk4YWdTNW40ekFoeElKTDkyK29lYlp2ZTdq?= =?utf-8?B?RUxyZmFKTmdWamJKams2OUdmcUdaZG5BVTB5UE1ROW55RUZNVWlYT0lhR01o?= =?utf-8?B?bmFMbGZwZ0RpTWpOY2MxMzM2aTd0OGlsY0p2WHN1Q1IwaWFOY0YyakI0VERT?= =?utf-8?B?cWdIZ3RwdlFVZUlvaXNucWZUSUN2aTBseHZyS05kMS9tZnZCUDhCTUtsTmpR?= =?utf-8?B?cUExWGJXdnU3OGsxZEcyMnlhNm1VK2t3NHJjL0RiQ2dQbXB4aHROUnBodmIv?= =?utf-8?B?dXpJK1ZVa1NnSEZ3T3RwL2VjS3JFOHY3NFVEdTJwc0VGSmdRN21uMHJTWm5Y?= =?utf-8?Q?gyWmPgYEzP4QRv1+wlGiByYfTF7cFuf5+2P0zp3fg2EY=3D?=
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2995; 6:a6zaHoX/+NechTVWlmvD0lAoCcxhnd4cMDU3rOs+wsx31nb9ZkZBhq7NEMaXuImpqpWrwtQYc24Hd5m/6omFnkC4zZnLkfNP7JSGZHu8YE0580Ilm6/d1zNK2wPqTOvR0spuKfxlcMKVPxf+u247Eizgq/nZnkV5s1aSu1HmDhlFVUQDhVgDyLhYfULocPDCjhEy3/xlPquphxrbXnNxhsEmnXQ5O+9lSeH1SnX99de+b6kggCCm6azPCX+BRj5gBR3zdpLM8ZS8/Vh6v4OkHdXjaRk1MPwpvOsoHsQvp5W6fKF7U7VgbIkjQaNQ1wc4gE6rbKCi0WahwzTBkQGJRHViVxuESDxsom1LELp0beY=; 5:IUMUX7Qa48Z2pGJxS3IuoByuOMFhA03k9JJA+i7Hl39nQWDLvpaZulnHm3RWmnM/3cjOQhMdk5BMqIQMxOnGsJfvxefUCNBlH9FCyQIhRgqeAjyltLc3cSW/TgrR/Ltz+3Jq2ywKk8th0mPAbia2gqGaQTs5DY/+CH+hZ9M3980=; 24:uJ7fg9QnWb5SOT+tlnK9ftuacYh3EJRvSOy+WrLWChqaLBQFSlOccBiH1nxmRWCK3G3us/hvuTsbPnnbDNd3s9/k52kzPqX3rzkV8li74aU=; 7:ASt+KTnPNF7E7XO+AkUM9Bw1AOpK8UdkglP2ArnXEwFZ9/kB1WnTjEmLmLoChXFSQOyZSlc0W8l76TmgzqLFulZDnQObP/YdD/KnmPHdZAn2x4dpXBi7yiClwrctcq3rzhLpFUvVsfudVW6Z4bcsb2C5ga/jjYD6xDjFsd4zdvLBku5fOBxL8PHsCR7910XgsURO8vJHgCauqFVQdSdMbQqAbRjrso2mjXy5x6sx0ovfP18nh4YawBeK2OIH3NSE
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Oct 2017 11:12:44.1194 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: d64e3a5b-3359-47dc-7400-08d51d2ba5ca
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: cf8853ed-96e5-465b-9185-806bfe185e30
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR0701MB2995
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/vBAJpyLucIBX7ROKSYYwSvU6Wqo>
Subject: Re: [netmod] I-D Action: draft-ietf-netmod-yang-tree-diagrams-02.txt size
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: Fri, 27 Oct 2017 11:12:49 -0000

----- Original Message -----
From: "Mahesh Jethanandani" <mjethanandani@gmail.com>
To: "t.petch" <ietfc@btconnect.com>
Sent: Thursday, October 26, 2017 6:35 PM

> On Oct 26, 2017, at 9:50 AM, t.petch <ietfc@btconnect.com> wrote:
>
> Lou
>
> I like the advice that diagrams should be one page long but wonder how
> to apply that to those I see in routing WGs.  I have just been looking
> at
>
> draft-ietf-teas-yang-te-topo-12
>
> where the diagram is 36 pages long - which may be one of the larger
ones
> but by no means exceptional - and I think the diagram is  more or less
> useless as a result.  But what practical advice can we give them?

How about using the depth of the —tree-depth option to generate smaller
trees that may not give the whole tree, but at least give you a nice
overview? Follow that with smaller chunks using the —tree-path for each
section of the tree.

<tp>

Yes!  That is what I do manually when I really really want to understand
and refer to a module - but it is time consuming and tedious.

I look to have a top level of less than a page and lower levels which
may be bigger.

I think that this also interacts with groupings.  If a tree diagram with
groupings expanded is 6 pages and one without the expansion is 2 pages
plus one for the grouping, then I would prefer the latter.  YMMV but I
think that there is a guideline in there somewhere.

Tom Petch

>
> I append the diagram below
>
> Tom Petch
>
>
> start of diagram
> ==================================================
<snip>.

>            +--ro altitude?    int64
>            +--ro latitude?    geographic-coordinate-degree
>            +--ro longitude?   geographic-coordinate-degree
>
>
>
> =====================================
> end of diagram
>
> ----- Original Message -----
> From: "Lou Berger" <lberger@labn.net>
> To: <netmod@ietf.org>
> Sent: Wednesday, October 25, 2017 2:13 PM
> Subject: Re: [netmod] I-D Action:
> draft-ietf-netmod-yang-tree-diagrams-02.txt
>
>
>> Hi,
>>
>> This version addresses all known / open issues in the draft known to
>> the authors.
>>
>> The changes are as follows:
>> - Added groupings and yang-data descriptions
>> - Added Comments, Long Diagrams and Security Considerations sections
>> - Clarified representation of schema mount points and representation
> of
>> modules exposed using schema mount.
>> - Miscellaneous editorial changes
>>
>> Lou (for draft authors)
>>
>> On 10/25/2017 8:49 AM, internet-drafts@ietf.org wrote:
>>> A New Internet-Draft is available from the on-line Internet-Drafts
> directories.
>>> This draft is a work item of the Network Modeling WG of the IETF.
>>>
>>>        Title           : YANG Tree Diagrams
>>>        Authors         : Martin Bjorklund
>>>                          Lou Berger
>>> Filename        : draft-ietf-netmod-yang-tree-diagrams-02.txt
>>> Pages           : 11
>>> Date            : 2017-10-25
>>>
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod

Mahesh Jethanandani
mjethanandani@gmail.com