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

Lou Berger <lberger@labn.net> Fri, 27 October 2017 19:40 UTC

Return-Path: <lberger@labn.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 9B870139612 for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 12:40:45 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.201
X-Spam-Level:
X-Spam-Status: No, score=-4.201 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, RCVD_IN_SORBS_SPAM=0.5, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (768-bit key) header.d=labn.net
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 MSIvB08UfNTy for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 12:40:43 -0700 (PDT)
Received: from gproxy2-pub.mail.unifiedlayer.com (gproxy2-pub.mail.unifiedlayer.com [69.89.18.3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 80D2F137E0B for <netmod@ietf.org>; Fri, 27 Oct 2017 12:40:43 -0700 (PDT)
Received: from CMOut01 (unknown [10.0.90.82]) by gproxy2.mail.unifiedlayer.com (Postfix) with ESMTP id C09331E0DA4 for <netmod@ietf.org>; Fri, 27 Oct 2017 13:40:40 -0600 (MDT)
Received: from box313.bluehost.com ([69.89.31.113]) by CMOut01 with id Sjgd1w00W2SSUrH01jgggM; Fri, 27 Oct 2017 13:40:40 -0600
X-Authority-Analysis: v=2.2 cv=K4VSJ2eI c=1 sm=1 tr=0 a=h1BC+oY+fLhyFmnTBx92Jg==:117 a=h1BC+oY+fLhyFmnTBx92Jg==:17 a=IkcTkHD0fZMA:10 a=02M-m0pO-4AA:10 a=wU2YTnxGAAAA:8 a=voZKSeMjAAAA:8 a=48vgC7mUAAAA:8 a=nZT61kyedtMgwWHzslEA:9 a=CeDx01oTrxxHmUpt:21 a=GV8UPRuREXzylEK6:21 a=QEXdDO2ut3YA:10 a=Yz9wTY_ffGCQnEDHKrcv:22 a=9_PflfxPP4jfUBPIDKbT:22 a=w1C3t2QeGrPiZgrLijVG:22
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=labn.net; s=default; h=Content-Transfer-Encoding:Content-Type:In-Reply-To:MIME-Version :Date:Message-ID:From:References:To:Subject:Sender:Reply-To:Cc:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=Pb7oWU2VzA0WKn9JyGGyBeFZI1EXJN/F0STRD3Oe/O8=; b=JxxqhenJVnb1msLcgEnw29pJYx Yj7K6dWJLi+QACM08D7feOVG33d6TiE96QKkw27rzaPdJ5OusBaxUKDlb+HUXxHhau1fL1CL9wk7X mlHUG8M90COyEWCg+Ctg1W2FQ;
Received: from pool-100-15-86-101.washdc.fios.verizon.net ([100.15.86.101]:42314 helo=fs2.dc.labn.net) by box313.bluehost.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.87) (envelope-from <lberger@labn.net>) id 1e8AUf-002aU0-4d; Fri, 27 Oct 2017 13:40:37 -0600
To: "t.petch" <ietfc@btconnect.com>, netmod@ietf.org
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> <013401d34f46$42976740$4001a8c0@gateway.2wire.net> <20171027172027.f6ki7wljdwmwzwib@elstar.local>
From: Lou Berger <lberger@labn.net>
Message-ID: <eb575880-c11c-3614-2b55-2beab6e4c1b4@labn.net>
Date: Fri, 27 Oct 2017 15:40:36 -0400
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.4.0
MIME-Version: 1.0
In-Reply-To: <20171027172027.f6ki7wljdwmwzwib@elstar.local>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 7bit
X-AntiAbuse: This header was added to track abuse, please include it with any abuse report
X-AntiAbuse: Primary Hostname - box313.bluehost.com
X-AntiAbuse: Original Domain - ietf.org
X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse: Sender Address Domain - labn.net
X-BWhitelist: no
X-Source-IP: 100.15.86.101
X-Exim-ID: 1e8AUf-002aU0-4d
X-Source:
X-Source-Args:
X-Source-Dir:
X-Source-Sender: pool-100-15-86-101.washdc.fios.verizon.net (fs2.dc.labn.net) [100.15.86.101]:42314
X-Source-Auth: lberger@labn.net
X-Email-Count: 7
X-Source-Cap: bGFibm1vYmk7bGFibm1vYmk7Ym94MzEzLmJsdWVob3N0LmNvbQ==
X-Local-Domain: yes
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/JFA1MK0XzoT8D-szS_yYxUg7-PY>
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 19:40:46 -0000

On 10/27/2017 01:20 PM, Juergen Schoenwaelder wrote:
> Why do we come up with such rules in the first place? It really
> depends on the modules and their relationship and it is the
> responsibility of the WG, the authors, the reviewers to produce a
> reasonable document.
> 

My personal view - Because having a few knowledgeable people doesn't
scale and not all model writers are at the IETF.

Lou

> /js
> 
> On Fri, Oct 27, 2017 at 06:08:31PM +0100, t.petch wrote:
>> 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
>>
>> _______________________________________________
>> netmod mailing list
>> netmod@ietf.org
>> https://www.ietf.org/mailman/listinfo/netmod
>