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 12:38 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 4B28813B262 for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 05:38:17 -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 (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 hl0LH5tj_wij for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 05:38:15 -0700 (PDT)
Received: from gproxy10-pub.mail.unifiedlayer.com (gproxy10-pub.mail.unifiedlayer.com [69.89.20.226]) (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 BE20913A8A1 for <netmod@ietf.org>; Fri, 27 Oct 2017 05:38:15 -0700 (PDT)
Received: from cmgw4 (unknown [10.0.90.85]) by gproxy10.mail.unifiedlayer.com (Postfix) with ESMTP id 1AA6B140467 for <netmod@ietf.org>; Fri, 27 Oct 2017 06:38:11 -0600 (MDT)
Received: from box313.bluehost.com ([69.89.31.113]) by cmgw4 with id Sce81w0042SSUrH01ceBWB; Fri, 27 Oct 2017 06:38:11 -0600
X-Authority-Analysis: v=2.2 cv=JNNLi4Cb c=1 sm=1 tr=0 a=h1BC+oY+fLhyFmnTBx92Jg==:117 a=h1BC+oY+fLhyFmnTBx92Jg==:17 a=IkcTkHD0fZMA:10 a=xqWC_Br6kY4A:10 a=02M-m0pO-4AA:10 a=wU2YTnxGAAAA:8 a=48vgC7mUAAAA:8 a=D2vAwGANpPmac-ssmSAA:9 a=-JxZ8xcSciFRdnWX:21 a=vSDJ_gyedrXwH5x5:21 a=QEXdDO2ut3YA:10 a=Yz9wTY_ffGCQnEDHKrcv: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=SkPlBtZK2GwQ+GwaOioTRz7Az5SEq31HFReb2AyjOnA=; b=JgJcYa5e6wlF+mnNAQY6GVjoYW AauGplAL+4toOxA5B2O2hfyyeCHCCIDkvvhVzU3Xvgcs0RFHEbZnTKO2eNCPSrVZXq3yUUad5doXV DGLeTKZeTmZO5yYq4wdCMPVd4;
Received: from pool-100-15-86-101.washdc.fios.verizon.net ([100.15.86.101]:50424 helo=[IPv6:::1]) by box313.bluehost.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.87) (envelope-from <lberger@labn.net>) id 1e83tn-000tkX-T0; Fri, 27 Oct 2017 06:38:07 -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>
From: Lou Berger <lberger@labn.net>
Message-ID: <63fca2cd-e41e-5d79-2290-41e0d0541ccb@labn.net>
Date: Fri, 27 Oct 2017 08:38:04 -0400
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.4.0
MIME-Version: 1.0
In-Reply-To: <03bb01d34f14$2907e5c0$4001a8c0@gateway.2wire.net>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Content-Language: en-US
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: 1e83tn-000tkX-T0
X-Source:
X-Source-Args:
X-Source-Dir:
X-Source-Sender: pool-100-15-86-101.washdc.fios.verizon.net ([IPv6:::1]) [100.15.86.101]:50424
X-Source-Auth: lberger@labn.net
X-Email-Count: 4
X-Source-Cap: bGFibm1vYmk7bGFibm1vYmk7Ym94MzEzLmJsdWVob3N0LmNvbQ==
X-Local-Domain: yes
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/Ko470e6KvWchynDAxeXFEknblVA>
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 12:38:17 -0000

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
>>> 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
>>
>