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

Andy Bierman <andy@yumaworks.com> Fri, 27 October 2017 19:56 UTC

Return-Path: <andy@yumaworks.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 C65C913F3E6 for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 12:56:45 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.6
X-Spam-Level:
X-Spam-Status: No, score=-2.6 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yumaworks-com.20150623.gappssmtp.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 PlgT1dDG3CA0 for <netmod@ietfa.amsl.com>; Fri, 27 Oct 2017 12:56:43 -0700 (PDT)
Received: from mail-lf0-x22e.google.com (mail-lf0-x22e.google.com [IPv6:2a00:1450:4010:c07::22e]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id B4FF9139612 for <netmod@ietf.org>; Fri, 27 Oct 2017 12:56:42 -0700 (PDT)
Received: by mail-lf0-x22e.google.com with SMTP id g70so8568186lfl.3 for <netmod@ietf.org>; Fri, 27 Oct 2017 12:56:42 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yumaworks-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=uBIOzCErYD9TTt1f7YuI/6WXyIJidzir+7wBRN7jS/o=; b=KYVIIh4hZ0uwB2aFoiZddq2xMfdRLN1/XsF3EyZZgNJBkV1LLneMv1DzqUzUOCI/AT B4Og6LoNn73TLk6lL/oPavKiaakb1Fw6KI/Up4vk8uL4nlIjJ9FjQUFgHTz/VpzecnqE CSblWUQ6fQ608VYWTxn4YfsWleB7Cpbfv73fUSQmH97jyJMhUAdRM97+GFQv0/RAvG1p oz3+ZfKbqUYyshcJW1TAEgm6zOEVYlcxQy+DRcd9teZ/EVnL1q1aZcQyWTH0LEmct27X S0EYQS0J4ZqL7EnYkHtrzFl/qtgmGC6vvubKeH70xhV7qabVrrF1IofZAwmjyvssixz8 1y6w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=uBIOzCErYD9TTt1f7YuI/6WXyIJidzir+7wBRN7jS/o=; b=hcdDOUHERzcPmcTE1NBrUB8dFYMRXWYVJzMEI/vTMcRyUvQck3J5KX3xQxTavy0T7t 7zY2yUzMTinUIuyWUytJF+y9AsKcNAWg88iFpwJ1FshGhIXOxLm3WblhVLulSUg8PvJW 1c7H7jg8SEK6BW1FPI3gktARXFVjrOXBm+Mx53AMHZBJi/8oZpdMT/Y7F0JQo3LY/FJk DHQ3Z/H+WptYz3CrngaD3sEsKlu6kZUe8e3/ggqcmAnX0ZB0UD5Afl+ZJ2n87HxXK5Uu XorZIps9Q6enbCCNDwVBOaPa54NeUvDTrAdP5StMQPmwSdXLo92j7eT5WtcciPx8Bj55 hP3Q==
X-Gm-Message-State: AMCzsaUCTwWsDklZWtfDoYVCBnOhVHYyF3YeToVcOnOm8UUouH6NFj2H CA4qDmpTMIrTXRPDT12DvdazTS+9zfXFp7lHtBJRGg==
X-Google-Smtp-Source: ABhQp+TMU42NyacAOiEtApRkErSA+3NQaAG6ZlflX0j/jtFna1FSCIb0uyakUO4g3pFcOcY8DxfAzySX9hqWl+ZHAcw=
X-Received: by 10.25.104.21 with SMTP id d21mr503730lfc.45.1509134201000; Fri, 27 Oct 2017 12:56:41 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.25.150.198 with HTTP; Fri, 27 Oct 2017 12:56:40 -0700 (PDT)
In-Reply-To: <eb575880-c11c-3614-2b55-2beab6e4c1b4@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> <013401d34f46$42976740$4001a8c0@gateway.2wire.net> <20171027172027.f6ki7wljdwmwzwib@elstar.local> <eb575880-c11c-3614-2b55-2beab6e4c1b4@labn.net>
From: Andy Bierman <andy@yumaworks.com>
Date: Fri, 27 Oct 2017 12:56:40 -0700
Message-ID: <CABCOCHQ4j7Z43k+GDcMT0PJV47-P6GSGTNYLZ-bK7BzY47_r9w@mail.gmail.com>
To: Lou Berger <lberger@labn.net>
Cc: "t.petch" <ietfc@btconnect.com>, "netmod@ietf.org" <netmod@ietf.org>
Content-Type: multipart/alternative; boundary="f403045e5616f82a3c055c8cafca"
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/jQhjxijSwnbpkClMO-E3M8OSMso>
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:56:46 -0000

On Fri, Oct 27, 2017 at 12:40 PM, Lou Berger <lberger@labn.net> wrote:

> 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.
>
>
It is easy to add a guideline that says "a YANG tree diagram MAY be pruned
if it is too verbose, in order to improve readability.".

Not so easy to define "too verbose" or define what should be pruned.
This is where I agree with Juergen. The authors and reviewers have the
responsibility to make these decisions.



> Lou
>


Andy


>
> > /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
> >
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod
>