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 17:11 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 E9B6B13B488 for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 10:11:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.921
X-Spam-Level:
X-Spam-Status: No, score=-1.921 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_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, 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 hwF3CWUWqZlp for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 10:11:25 -0700 (PDT)
Received: from EUR02-VE1-obe.outbound.protection.outlook.com (mail-eopbgr20100.outbound.protection.outlook.com [40.107.2.100]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id AAE47138A38 for <netmod@ietf.org>; Fri, 27 Oct 2017 10:11:24 -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=JgVSuGo21cd+gevoJ8gt+6kbvHnRvVDRWilkz3QNAYc=; b=dEISrGgisjCf/cm+Yo57nCjGLLCAqYmU2mFmkGpHHc08VafJUJmqSbWvscqSPox02liQbngunADvCPuVjs4+2uvE1Rwpj+BTkPtgjxPEv5ShnSa7zGruvuPX+LkI7ZAVU8JD4I52RcmbrkeSGTGK71lFUdwYbsyzE2xoXWM3oaE=
Received: from pc6 (86.169.153.236) by AM5PR0701MB2996.eurprd07.prod.outlook.com (2603:10a6:203:48::18) 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 17:11:21 +0000
Message-ID: <013401d34f46$42976740$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> <03bb01d34f14$2907e5c0$4001a8c0@gateway.2wire.net> <63fca2cd-e41e-5d79-2290-41e0d0541ccb@labn.net>
Date: Fri, 27 Oct 2017 18:08:31 +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: DB6P189CA0032.EURP189.PROD.OUTLOOK.COM (2603:10a6:6:2e::45) To AM5PR0701MB2996.eurprd07.prod.outlook.com (2603:10a6:203:48::18)
X-MS-Office365-Filtering-Correlation-Id: 39968f00-5c0b-4613-329a-08d51d5dbf3c
X-Microsoft-Antispam: UriScan:(178726229863574); BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(2017052603238); SRVR:AM5PR0701MB2996;
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2996; 3:2m/86sthchwXR8C1dI7Infr+ppk9nuiZxGG9y67SZoGK84YbDAnnUJXq6Obo56nm7ja7O4icwnmu8kHs6mTn2jzrX55EghWiZVdwbOKMOvFVR2OlbUTmXp/ZmqheuVKG6XLdMuU0iDyNo+9unwlXiidzQGIp522ixp73X9tBRiDddk6p9qFCC4i7vmLnVYmmokZAG0/vC9Ds+oSK98vbmauMB2R35sRCM0MNmuekbuTOzWLjCcTxJZ/rojoHLR9WYAitDk5UR5gP5G/RE2i+K3jnKirqJ7/fUbpScaJfMU8=; 25:EqyIfPSYUQk0vDk8j76dYOz6i0jJsO0ev371ridJuMMV2TyqKMSCphGFuykq48G1hhQioOwkaN/oAppR0XLSS79v2w/+cohYJu0eGBLnS0S0l+bvGaPAJoaz4RLageuAxxhkjh+/MnGYcMuI4zfEc6F2g01Ol8sPy5TGhHnYwFtt4SN+7KZgx5PVnomRbzgtpuuP5zCjltWszY22QZDUAGFU2Gwf8jEmYVnjp36aSNTbezwfm48ijvECHZ7/qQTU/SNKycxrhyy10poP78QCydRV4uk+50ynAbjBnE1VigT94pVuEjK8AlLiYHkRZSVIhGG2t6Q5YfADSpcyd7+Pxw==; 31:uqyoL6tuHr2oXKSrTBxp35I0iTTFpDAl2zbJ5yc6iBsz4yWyexE2O3kqtGB4QbF+8QKg39E1ZDf3OGzJjL83xWOmQOle7txZzhCwKN0cfIAyO9WqrjpVes1DVrgvqav5FZOsKoqoOsVcI6WLuKqqz9WtyMgATld1RW5W4cOcHS1tkOiCN9ImexCJhW78NtsX+eirJ3+xn6lFclvfck7XZn4t5VIMlBo1G4oMcJAqCwk=
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: AM5PR0701MB2996:
Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=ietfc@btconnect.com;
X-Exchange-Antispam-Report-Test: UriScan:(178726229863574)(192374486261705);
X-Microsoft-Antispam-PRVS: <AM5PR0701MB2996573F368D11CC7FE18BBAA05A0@AM5PR0701MB2996.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)(3231020)(93006095)(93001095)(10201501046)(3002001)(100000703101)(100105400095)(61426038)(61427038)(6041248)(20161123555025)(20161123564025)(20161123558100)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123560025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:AM5PR0701MB2996; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:AM5PR0701MB2996;
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2996; 4:aPI5A40eJxwWKfM4S+4LlxH7mBl+NGo/OwmF85RSfLvSbpuyuQ4fZLzFy0S4QFPOoggILUsXlSHiRZZitDDjj6XoomG23gxKP8o/Xl9keTkQlOJio4RIo/xJJQdmTZFX66uHZGE3IwujGtOiPaewhjVZizYObWllK03zEyut64jO0TFaEt+g+5OvGxt6EymoDgnZj6OqN7RH0HDrQoqrUec5XOhtahMkKzBO7GPHAuYb/DkcL4PUdEXkQgZkO8ctrylHFXScOxmnuWtmyfQJrwiANAR7kHDuqnBv2vc/s68sX6h9EPR+vj1KIf8y1R1rmQ9dtp928t3bt9wpR8ryz9DpL9tpnjmOKCnz0xHqqAQ=
X-Forefront-PRVS: 0473A03F3F
X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(979002)(6009001)(39860400002)(376002)(346002)(24454002)(13464003)(199003)(189002)(33646002)(1456003)(76176999)(4720700003)(6496005)(7736002)(9686003)(230700001)(106356001)(116806002)(229853002)(68736007)(101416001)(189998001)(6246003)(105586002)(81686999)(230783001)(305945005)(44736005)(84392002)(6486002)(110136005)(61296003)(50986999)(47776003)(53936002)(50226002)(81816999)(6666003)(8676002)(62236002)(66066001)(53546010)(50466002)(14496001)(93886005)(81166006)(6116002)(25786009)(316002)(44716002)(2906002)(81156014)(3846002)(97736004)(8936002)(86362001)(23676002)(1556002)(16526018)(478600001)(5660300001)(74416001)(7726001)(969003)(989001)(999001)(1009001)(1019001); DIR:OUT; SFP:1102; SCL:1; SRVR:AM5PR0701MB2996; H:pc6; FPR:; SPF:None; PTR:InfoNoRecords; A:0; MX:1; LANG:en;
Received-SPF: None (protection.outlook.com: btconnect.com does not designate permitted sender hosts)
X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtBTTVQUjA3MDFNQjI5OTY7MjM6MGRoeDhvNC9NNnlaK3F0cjdVcXVNd1g3?= =?utf-8?B?Q2xNaFFKN0dTTW9WTnQ4NFowS0dMN1dnWmQrUkdNK3Q2S0NVVzdBSkRDeTlm?= =?utf-8?B?cTlqVWh0T1g2TW9qekNyTDA4REwvTlk4eVJxUFVXN3psQWNFbjJWQTFPZ3Ir?= =?utf-8?B?T1krOENjVm5lRHVKNSsrdWlMbHcxNStrYlM4SVFtd0RxSi81cmRodWVJaUxC?= =?utf-8?B?UXdPZCtrZU5qZlFDSWtPOHdGNWpqR3ZEZkZtOWgyUUZJZElWRk94aUIzR0dy?= =?utf-8?B?LzhIWUMrZTB5bnpKaW1MclVpZ1BpK0I5emhYZ2xXMDYzeXBCOW9lRGdOemJi?= =?utf-8?B?OHRuRUtQNHhJQmx1S1RrQmxISTBBNFY0Y1RYUCtabTAxRzYrQlFMRUZSdXRH?= =?utf-8?B?anJiQUQreUZDMncwYnkwTjdpV2Y5YTVDUHprajNZbHpLQzJIalQzdkdHQmZq?= =?utf-8?B?d0VvelE1UUxoNTNqTTNRanYyZ0s4YVBKNndPbU5jN0prcEhaYjVZWW04aUgz?= =?utf-8?B?d0N5SkhYY3lvM0RqY0FZT1VWcng0dTM2elIwV0tmc1IrdSsyV2J6LzYrbVEx?= =?utf-8?B?TWZHaGdjdzdpbjdKOENvajQ3YWF2Nm80NHgrN0hXam9MMkxoNUJ4djZJYlBS?= =?utf-8?B?TE51VVVwNkpZSUV4K3JZRDlCQ1JyMlZ2MFNYNVNpdW1CaUs0L24yU2JtNGgv?= =?utf-8?B?Qk5KYk5XQUhHTnJPcCtMMzF5MHczZkxQVXdPdTA3OHU2Rkh0RU9yTXFWcEJ2?= =?utf-8?B?Q0ZDUUNiTFB3SGlOMndEN1JTRDdSaXlnV0lMNWwxNnFtV29uNmgrRm96Ti9z?= =?utf-8?B?a2JvK21WTUZnVmJlZlRPcUVUWkg5VDlCNlc3QUtrciszSVB6VUlaUDFnODI1?= =?utf-8?B?bUx3OForWmN2bE5OQWpCcSt3UWNSTTNJWlhKcVBpL0V5UVhKTjcrTGcvT2xF?= =?utf-8?B?SDNJcE9mMjY0SFpsb3E2Y3YyeWpUalRUekJuc1Y1bHZVNkE5WE0vanltWmZr?= =?utf-8?B?QnAzdGVQaWozRGxOZ1V0Z3J0V2xGRDZRQWpiNFlsY2N2Rm9aTXJHa3U3Sm5L?= =?utf-8?B?UWNVY1dselNZT1RyVTR3Sm4yK3c3MDgzOFg3bVM1aFhaZXlpZGQrZjZxRUdn?= =?utf-8?B?NERmbEUvdUszNnY1eVhrRW5pOXpPWUpoUTBDZ2R4bTJxUEJ1RmNjZHluZURS?= =?utf-8?B?LzFVYURsRjlIaDRmMGVWSGdxYWkzYWRMUEkwV3BZNkx1NHR2YW03UFFGZnFh?= =?utf-8?B?S205TUJzNTlaRWlaazdFVlZxWG5Bdi92bWwvSzk1U3ZVVHBwN29MS3c3ckV6?= =?utf-8?B?akFTSE9GaE5kYmk4Ui9OZ2owZWk5T1Y3c0JWOWhDT2UwTlgvbURubGxYTHNK?= =?utf-8?B?SDBHc1NmVDFkRkhnaUM4NTg1UzcwSWtZbmtnYnJxRVcwMmtGRHFSL0tqb08v?= =?utf-8?B?Y2dWejgxQ2NVV283UUl1RHc4QkNnWGJoL3cxUUpzMWxiWDZtWUFMOEZQZTdQ?= =?utf-8?B?MEpiL1hmRStlbHA3cDRrWmZXYmwrUVVEQjArcXFNVDZnNndOYmdsNG5kbmd3?= =?utf-8?B?blZ6aW5NamozQ3h0cGVJVUxyeDJkelF1eE1RZjRJWmJuVWthKzdBS0R0OTdh?= =?utf-8?B?aE9XSjQ5dmRLaU1wR1FvamphUmQrUHhDejBHcTI5R3hoZmZOK2ZxbmdKcUds?= =?utf-8?B?ZkdOTjI2a2xtdWdaSWMwZ2JPR0pacFpZcWlhWHVheHpQUUNHb3BueElwdW9w?= =?utf-8?B?RWFXS3FYcEpNdU5HbHdTTjgwWmtvYmxTTXV4SkgyT2pLWkV2aEd2YS90bFM2?= =?utf-8?B?UVN6RXhvUjVGYzQyUk91Y0U4YTJsR3hBcnRhNUZRbWI4L3pteWNLWWhHZzBs?= =?utf-8?B?QXZSTnk4YkFGT3IzL0xQRzZqOWFMQ3kvVTZxVktRdkZWK0tLaFBuWEhkbTEz?= =?utf-8?B?V2p2YkwzK3VrSU1JOXJ2SytSRm9FQjNaR1REc1ZtamtNRHFZYzJXU0xUL3h6?= =?utf-8?B?NWFQRTF2a1JJbFVhc1VwL3lhZE95ak5NQjZyVk9MNWZ5ZFBrUitOTVdkVmlL?= =?utf-8?Q?aJ3dNlFdl1J0EFZiVzjfY5jBYKM?=
X-Microsoft-Exchange-Diagnostics: 1; AM5PR0701MB2996; 6:S9e8zo/jEwRavH0iLr0JRMiYnes5gNH5haJRwu6SqNn74XRBi10vrlgME9NVdYOvhnojMNNVC9acxXpcxOim9j7vVzmITkDR1X4ZhfD1i8tYMuQd965hv5iatNIEElguPhlMlvSxVdTKeVHZtfEMziM6mNCpXjk3j4EUgpD4vzMw4dmRetTf7hPGah2aOdCKNohh1av8G2885QWamhCogmzddlA61TqAvNfUttvq/pShiUWvLKT9F6PEdGXXIXb/6BT5sKHmjRQGrdhZLJciLyy3hWwYXbDT16y81uxEE1jxrzklC3HfDR6FincAY5S02szdqj0AoGj/7UAUEMjALrWQO9eXUEVNuJSKOgkkFyI=; 5:achif78O1pJMGh9NFGv6aK8baqp6cFbYwpXa/Wz8FWUTXbLcfOL39QjHwD4H9bOl+7aIif4ZxzfYuk+cQDfEu9od0wTdZi37gYbxnW2Iz0xMRmXeWawFHZJqBlZpIyszQsHHYjya8ECUTCYIrdnGFVx+0Z/u8Qmjk4eXZrNqpxY=; 24:86bLPfRVoJABOYfYNpHjQTYOR+RpXjBKW4VK3qGjf3Bnr94wWJrl7ytf0yaMbRGSbltloZKY4YbKBr2JYGlQgGYqwLkQyAl8zGiDcVMJCBA=; 7:puwWHEVEXQp55dqTk+jbH/izBZ8DcoznNY583mrzu4jsjWtU2rzcHywMSLomm7xV1pScTbqWPxbjqLP7v4FBA92aVUR1NqB17i0AqF5qAOS9fooV6rGIYRaQfp695R3oG6Apq5OX0AUHzt7ifP/iMDaFM+yGR+Ap52DIyw02IT4UU81GbW4dWNxD2p602AjRrqtlzXgZ8H/5PtAjdMaDA28c+6JW5Z9PViJ8inAQTBSsPU1ObP5VSD3rRYP+60SE
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Oct 2017 17:11:21.7381 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 39968f00-5c0b-4613-329a-08d51d5dbf3c
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: cf8853ed-96e5-465b-9185-806bfe185e30
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR0701MB2996
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/GHSTdlIffMEMYb5Wn-LaLrWIrVs>
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 17:11:27 -0000

Lou

Suggested text

NEW

3.3 One Document Several Modules

When a document contains several YANG modules, all the tree diagrams
should be placed together, before all the modules.  Each tree diagram
should be preceded by a brief introduction to highlight where one tree
diagram ends and another starts.

If a document contains a single module which is logically a number of
distinct components, the same strategy should be followed; RFC7317
provides a good example of this approach.

/NEW

Like Juergen, I am conflicted as to at what point details like this
should be part of rfc6087bis; I think a paragraph like this does belong
in 'tree-diagrams'.

Tom Petch

----- Original Message -----
From: "Lou Berger" <lberger@labn.net>
To: "t.petch" <ietfc@btconnect.com>om>; <netmod@ietf.org>
Sent: Friday, October 27, 2017 1:38 PM

> Tom,
>
>
> On 10/27/2017 7:08 AM, t.petch wrote:
> > 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.
> Sure, Do you have text you'd like to propose?
>
>
> > 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