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

"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 C7E5B13F4FF for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 04:12:48 -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 AxmFSznX6wpz for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 04:12:46 -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 E1D1C13F4F0 for <netmod@ietf.org>; Fri, 27 Oct 2017 04:12:45 -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=z5TV1+EOrjzH6Ry54c0diwyh8O420U2MZYRk92mxfv0=; b=Lf4FAX8qfJnaxYlT6b45lZpQKDTTdof7nBSaCPQ3wz//VCObGaHqbomE7f8YMW8FA0xwFlZIM1BGYsqvQWbwgbwz0dII1xXDb8H4YKbfhmxaIYZZBgQDEOhM69pls0dQR1d9RfQeNw5awITgkCDZSe2Ig9hiViMY1Z+8CCLEtLg=
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:43 +0000
Message-ID: <03bb01d34f14$2907e5c0$4001a8c0@gateway.2wire.net>
From: "t.petch" <ietfc@btconnect.com>
To: <netmod@ietf.org>, "Lou Berger" <lberger@labn.net>
References: <150893578927.4882.2117597388624976982@ietfa.amsl.com> <23892572-a0db-d24b-e591-a19799ace9ae@labn.net>
Date: Fri, 27 Oct 2017 12:08:37 +0100
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: DB6P189CA0008.EURP189.PROD.OUTLOOK.COM (2603:10a6:6:2e::21) To AM5PR0701MB2995.eurprd07.prod.outlook.com (2603:10a6:203:48::17)
X-MS-Office365-Filtering-Correlation-Id: e81b9020-6c4a-48ba-dbd1-08d51d2ba550
X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627075)(201703031133081)(201702281549075)(2017052603199); SRVR:AM5PR0701MB2995;
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2995; 3:VMFvUg07Q4gz5AqoZjg6iLNCUa7OzNmB+4GYHWZfAFRRHT9aJXhD2U/9bV8pfTS7lRriqFm0fqIZxuQ859g7gSttiN5KbAznOJSbflpHL7iiCLkk+5sbvBQORyT6k+eZVV+vGJkRVu32EJnTAFkNvzFVMuFRiIVXvGOKyRaFP8Odr44qU6GhVF8qXIo0vPrGwppMPGt+eMYI8t0qjLq7rttD0C+wxNKSeZw/LfAJHvlhQjmhXLdaI9gSmgbod3Y2; 25:zhFwbnrleb50xZKq+LFSN3y4mXz8kTOQSTUtxXZaiez0hsOmV/Sv9eS7SHEhBo0ev5i/HzqSRRv35QU0zkvOuRQ7KU91Nt3Jh5uLjLMLknT5LKfSxQhPA075yyL9EOzmOIcdMnOLEJGBbTsISiAAA3pqkI7si64LUvSPHNKh1G97AH7paYHCFdYnCtvtFTVyEGBJBF4ynz7TN/kwU3mxLoAFraY4pcN4HK6GFro+afV8VoMABB0Qayw064vQItKgz+A3PvVrUmBvA9/ilUje/OStrV3oYurlEAO+W9l1xR4LF5lblYc5Ej0N+FBMqHhfwvPNkb1wG+PEfeMo1Y5o2w==; 31:pRvpPQ+3XLVxoL9WNxWi8uyKwoYotBi2Q32+u3EyPINfmblF+sESHhyU7jtq6KvWI0kosjOqNy9PWcglJY/uDdi3wn89W0D5MJBdMs82xE3gJhzMktciFWnoWOcDdPvA40K1vpUkFQDnjFPaW0i7JdQPNTM+cTr/6VeOJOVmFd+dD8yBBUZVWD2nkShSqO+O/VqH1Is6lKyrAH7/slnycW7Kvv7rmTyZgcFBaeqtqaE=
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: AM5PR0701MB2995:
X-Exchange-Antispam-Report-Test: UriScan:(120809045254105)(192374486261705);
X-Microsoft-Antispam-PRVS: <AM5PR0701MB299515DE75B9CF02DDDB6404A05A0@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:B8BC9PeDEdBPAFm3IqFgSXJoJWx2f6CigLzpnFj0qYXKfWCuLecKQwFOLEzdOI/Q+p3ckOjTCCDI6EgAWgNUxSBtPcZWcXux8TpRXQ2G7JTJ33AD3gS9CoV/9VcvFQwL5jR38Q1mjl5/IKbiTPe8zKntnv1uY8XwtscO3iZQjG1qZ8+BXyQn8f8041pQp0oXWdEqPO+kkenL+6wW8JGO8JP8YkLsF6m4K2569ELB1XFbkKr/MSvU+zTgeVbhAna0SPEDTAEafFySOiagi0eDS6zWMHrLeWs0ZLnv5+niA/Gi3K8jQhp4Hs7bvWwURNMX+mky9/zIjzxGnT31wQOe0YgnW2RKUh1Xbyl2HWrJxkY=
X-Forefront-PRVS: 0473A03F3F
X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(6009001)(346002)(376002)(39860400002)(189002)(24454002)(199003)(377424004)(13464003)(2906002)(68736007)(6246003)(230700001)(4001150100001)(966005)(8676002)(1456003)(1556002)(44736005)(50226002)(4720700003)(61296003)(81816999)(81686999)(110136005)(76176999)(50986999)(229853002)(6496005)(53936002)(6486002)(97736004)(316002)(101416001)(50466002)(25786009)(478600001)(84392002)(6666003)(53546010)(5660300001)(116806002)(105586002)(7736002)(62236002)(8936002)(44716002)(106356001)(47776003)(305945005)(66066001)(16526018)(23676002)(6306002)(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?MTtBTTVQUjA3MDFNQjI5OTU7MjM6VS96WkVmTzYxV0FydkZEUzRVMlVodkdK?= =?utf-8?B?NktDNTVPOTdkZ3d0SCt1cTg0NlpTWkkxeWY0WVAzdWluSnpGZytDZVZZRTAw?= =?utf-8?B?T0sveWtxcWRYZTdiOWVQNW05eXZSa0dsSGRvSU8zVElvQUZITHZSbDdQaC90?= =?utf-8?B?bGd3QmxlSTVBZkxIZklBelpCU25uWHJ1c0tzVlc2NWxyWStxZytHQm9JNVUr?= =?utf-8?B?V1BKSGxhNzFKZG4rY1M3dnZEUGtKK2pHWTl3MytQZnNBRjNlblZnWis3RGxD?= =?utf-8?B?eitJS0VYQkhHVG1xWEtwUm1heUtVbHladlUyZUpmU2NFTHcrSEV4MEh6YVly?= =?utf-8?B?UXZuYm1pWlZVeHFONW40QytmNldKNTRjMjVYME5lSHZCL1VyTmNpcXA1WElr?= =?utf-8?B?RFduVDlocnVXczVWUlRxb0ZKYm9TbjRWQ0ZpZzdaN2x3VDMzYUZIS3g1R2w0?= =?utf-8?B?S0NSL3RqV0RjdlcreTBVT0lnWXF0OUpZSkl6ZmR0YjJEWXlHSWZmNExqNTIw?= =?utf-8?B?UlZ0bVJ2NjM5QmNqdDFzZW1MY2cwanB6Y01nY0krN290OUh4WnFzeUpFdnEz?= =?utf-8?B?RjA0Wm50ZFV0aTRzRDdBeS9LSDFWaVk4QjZBV2dFOGVnQzA0Q3c0ZENJL1dW?= =?utf-8?B?Rlh1YW4yVnZ6T3hJeHVrOU0rMjB6ZGtzUUhLRWRmTG40TElRVTBwNUE2SGJo?= =?utf-8?B?TjlCdDFzMW91UzVZMzBKbUZJUjVZM0JCUUFyNW1oVXNrOVcxRnJQRWpnNVdZ?= =?utf-8?B?L3UwcFRoZzBRQ0hEM0ZlRHEyUVdhTk1SQnByYW8yaEVZKzAzTUptQW1iN0Zx?= =?utf-8?B?d2grem41Y2hPN3QrYm9mM3h3cURORlluR2FLN1YxKzlwMWxOcEdJcG1oZEgz?= =?utf-8?B?Z3QzVmliMEdScitsNVFaVlhIdlByVVJsNmR1R2tteXgxeFRxUitBNFUzSmpS?= =?utf-8?B?NTRucTcrM2FHTlBFbU9ldkVTaVF6RDJpaEVESTQ3R01YVVNNMFVsTUZFaXRL?= =?utf-8?B?WE4rSE1lY05mZFczNVBZeS9Hbng4ZklPWWlRTGZpTVFxaGRXTVRmTmdsb09k?= =?utf-8?B?TUp0VUY2bU5KSjA4b0lkNHkvR0pEbGxDbXNrMit2ZHBiTUFqV1N6SHRVcllh?= =?utf-8?B?ekJvQ1o4NUpIMTBjYUFmUTdXZkdIYjVuK2JkNVczNE9Qd0tONnJYckFtZUs1?= =?utf-8?B?enlaQkt4SlpSR3BTTzlJZ2FpejVDNkNSRkhqWWQvTGRlTjRsWEdPcDdJUGp1?= =?utf-8?B?ajhabDRSdmRDaEYxazR3UHl0eDVPYm5MOXhFcTlkRGpyYWU3YzUvUk0zYXZY?= =?utf-8?B?eXpML0hIZW1zNFF0ckJLd0gyd2JrRzBJOEl2eGU2b0liMlNhOU83VkJLNjA2?= =?utf-8?B?OTV2aDRxVGNvRndaeHRiSmpRTFZLZUpFcTcyREQyNUFNMGNZYlAwT0Rua1RE?= =?utf-8?B?UGZOU0RjYVJlSFF1blZUckZYcTI5MTkyR2NpQXFBcDd6cVhhV3ozRDB0YUda?= =?utf-8?B?am5OWGlucml1d1B0eVB4SDVtUXFuS2I2Ry8zZ3NaVFZGM0xqZmlZSzlMTVRv?= =?utf-8?B?QjZpNjZpVmJUb0VmUnJGd0RYbUdIaDhKV0cyVVpISlF4Tk0vRlNBY3ZVeVQ3?= =?utf-8?B?RVJBdzM2MXhLMEEycVFOTC9mOHkwUDRJRjh6Rk5OYWw3WnNvSTdnTkpiK0ZB?= =?utf-8?B?bUw4TE9MT1czN2JHbEhMWWNBMGdCdDdScjd5ZHFOaEFXN2ZDMXp1cTFYV3pH?= =?utf-8?B?eEp3OHpTSnlmODYwR2lxRUpTRXdtRm5oNWZnZ3dOZ0tWak1EemF5MVVHTUFF?= =?utf-8?B?cDB4YWt0RXVrZUdoUTNTSTZpQ0dOdmtmSVlwQ2pVOTRseS9iVVVJQjhRTEhJ?= =?utf-8?B?ekU1RmxPdDQyTXJmWWpJa29NNEZrOG5hR0xjSDNCR3VYdnppYXdiMG5Fd2NR?= =?utf-8?B?Uy9YMG5Ub3UxL081TXEycXArd09kTDNSTVV1TnZUK3VTWUJpVkZPQkIvNDR0?= =?utf-8?B?blFTZ0ZxTkZEL3ZYc3JNSTBib1ZSR2dhSlpON1duWWJHYjRSdWNaOVRzR1BT?= =?utf-8?Q?eA/Cno=3D?=
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2995; 6:EPPScyfiCLvu9RAbm2QD0goo4X4nmxgPsOwkXHVJwNMIHHCGP6CBUq1tbuoY16mmisYr8QrcdEyG+1OT/itBrQf4MFSQ9ZdnZIUZVrDNAjkWV0hYmOt0wFdaYY3FZTtwnyCCyG9hUbKuNr2ERrzN7NjoMH+TbR7aiHDENdNryl5bYhVywNBVr4iR36KeNvztqyRMaepZn+/ZkF4Rle7hBllS5iNAMSQvY/zmVYe0QDLNCK2AAjOPrt3q9pE5ukelqNpObVgwDckEVtssOBdB9NTmrsewx6XTRBwSwAoYihqqUyOBmBu9ro6wc+drpwXmVlTl2Re6KQiU0bD9DKYmcExFyBtnKiv2rliw3eQY6qo=; 5:QcbxxO7hm5GMS8BXavs350KJ2Qh8XL0wFpX9IBqPfxR8PC0sTmL/4Gx0wDXhwDPNbQqQqU1LkpOJwaINn7N4N1HlFF8fLNd0xIJOv3DpFskfpEFr5Las288+mpWtbbbUKLEztMDc66tynM9wXG3OWtHNQF5d/2nS3FhLD8Kd0/w=; 24:s/BVNJwSjASuAZehOC/Ym0MWbnXw3RJLGD59ff6rPo6vzEx0eMs0SGN5QCKRezm1hiDaRcjRl9RO5ptOdI8X0BNBIab5ndKx9T0uN4j9Pdc=; 7:lIKBGOj8J0t6vbe63Ax8j4b0+tYNDP4wwMM6v78BDostFa1cjWJ8tKbu1/3k4hlqdM0P4amaYgoVs+8EiNfxl7X0ry0XJfLSHARqGMU8o/fITr9WbOtEfgno+seaHWYQ2CM8s9m1Gk0P/EX7PVsqrExhjzPcaLVibeAoE/NJoAWWPKDVkiDQHvwbmJQnvrVN9IxeAoMO94y17/fRfr+nLxV/MK95MHztD7vW+ORUPrR0/XadJKXsDZrNv0Ctp/km
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Oct 2017 11:12:43.4007 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: e81b9020-6c4a-48ba-dbd1-08d51d2ba550
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/I0SAjQJ-HDgWPaaMfPv2i-zwOLw>
Subject: Re: [netmod] I-D Action: draft-ietf-netmod-yang-tree-diagrams-02.txt one or many
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

Lou

On a slightly different tack, so a slightly modified Subject: line,
when an I-D contains multiple modules, some place all the models
together and then all the modules, e.g.
draft-hares-i2nsf-capability-data-model-04 while others intersperse the
models and the modules, e.g. draft-ietf-lisp-yang-05 .

I think the former is superior and should be recommended, especially
when, as Sue has done, there is a brief paragraph of text before each
model, so it is very clear where a model ends and another begins.  With
the latter, models can be hard to find.

I see this as dovetailing into Juergen's comments on RFC7317 which, to
me, is really several separate modules packaged as one, so the
separation makes excellent sense to a reader.

Where the I-D is already several modules, then do as RFC7317 has done.

Tom Petch

----- Original Message -----
From: "Lou Berger" <lberger@labn.net>
To: <netmod@ietf.org>
Sent: Wednesday, October 25, 2017 2:13 PM

> 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
> >
> > Abstract:
> >    This document captures the current syntax used in YANG module
Tree
> >    Diagrams.  The purpose of the document is to provide a single
> >    location for this definition.  This syntax may be updated from
time
> >    to time based on the evolution of the YANG language.
> >
> >
> > The IETF datatracker status page for this draft is:
> >
https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-tree-diagrams/
> >
> > There are also htmlized versions available at:
> > https://tools.ietf.org/html/draft-ietf-netmod-yang-tree-diagrams-02
> >
https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-tree-diagra
ms-02
> >
> > A diff from the previous version is available at:
> >
https://www.ietf.org/rfcdiff?url2=draft-ietf-netmod-yang-tree-diagrams-0
2
> >
> >
> > Please note that it may take a couple of minutes from the time of
submission
> > until the htmlized version and diff are available at tools.ietf.org.
> >
> > Internet-Drafts are also available by anonymous FTP at:
> > ftp://ftp.ietf.org/internet-drafts/
> >
> > _______________________________________________
> > netmod mailing list
> > netmod@ietf.org
> > https://www.ietf.org/mailman/listinfo/netmod
> >
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod
>