Re: [netmod] choice/case in tree diagrams

Martin Bjorklund <mbj@tail-f.com> Tue, 06 March 2018 14:45 UTC

Return-Path: <mbj@tail-f.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 603F5127076 for <netmod@ietfa.amsl.com>; Tue, 6 Mar 2018 06:45:53 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.911
X-Spam-Level:
X-Spam-Status: No, score=-1.911 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] autolearn=ham autolearn_force=no
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 VNECe7C-YMW8 for <netmod@ietfa.amsl.com>; Tue, 6 Mar 2018 06:45:52 -0800 (PST)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id 094441243F3 for <netmod@ietf.org>; Tue, 6 Mar 2018 06:45:51 -0800 (PST)
Received: from localhost (h-80-27.A165.priv.bahnhof.se [212.85.80.27]) by mail.tail-f.com (Postfix) with ESMTPSA id 58DF31AE0339; Tue, 6 Mar 2018 15:45:49 +0100 (CET)
Date: Tue, 06 Mar 2018 15:45:49 +0100 (CET)
Message-Id: <20180306.154549.756915470498081734.mbj@tail-f.com>
To: j.schoenwaelder@jacobs-university.de
Cc: vladimir@transpacket.com, netmod@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <20180306133604.cdttv22mrjci5tnw@elstar.local>
References: <20180306124825.joukx2lvszeehrzt@elstar.local> <20180306.140023.524272795634334481.mbj@tail-f.com> <20180306133604.cdttv22mrjci5tnw@elstar.local>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/inq6-iiZ04YAEeGMZzzRSyLDFuQ>
Subject: Re: [netmod] choice/case in tree diagrams
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: Tue, 06 Mar 2018 14:45:53 -0000

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> wrote:
> On Tue, Mar 06, 2018 at 02:00:23PM +0100, Martin Bjorklund wrote:
> > Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> wrote:
> > > On Tue, Mar 06, 2018 at 10:44:11AM +0100, Martin Bjorklund wrote:
> > > > 
> > > > OLD:
> > > > 
> > > >        <flags> is one of:
> > > >          rw  for configuration data
> > > >          ro  for non-configuration data, output parameters to rpcs
> > > >              and actions, and notification parameters
> > > >          -w  for input parameters to rpcs and actions
> > > >          -u  for uses of a grouping
> > > >          -x  for rpcs and actions
> > > >          -n  for notifications
> > > >          mp  for nodes containing a "mount-point" extension statement
> > > > 
> > > > NEW:
> > > > 
> > > >        <flags> is one of:
> > > >          rw  for configuration data
> > > >          ro  for non-configuration data, output parameters to rpcs
> > > >              and actions, and notification parameters
> > > >          -w  for input parameters to rpcs and actions
> > > >          -u  for uses of a grouping
> > > >          -x  for rpcs and actions
> > > >          -n  for notifications
> > > >          mp  for nodes containing a "mount-point" extension statement
> > > > 
> > > >          case nodes do not have any <flags>.
> > > 
> > > I still think that it should be 'data node' instead of just
> > > 'data'. While not formally imported, the term 'data node' has a
> > > definition in RFC 7950.
> > 
> > But choice is not a data node.
> 
> EVEN NEVER
> 
>        <flags> is one of:
>          rw  for configuration data nodes and choice nodes
>          ro  for non-configuration data nodes, output parameters to rpcs
>              and actions, and notification parameters
>          -w  for input parameters to rpcs and actions
>          -u  for uses of a grouping
>          -x  for rpcs and actions
>          -n  for notifications
>          mp  for nodes containing a "mount-point" extension statement
> 
>          case nodes do not have any <flags>.
> 
> My point is that 'data node' is a defined term in RFC 7950 and using
> defined terms generally adds clarity.

I agree that using well defined terms add clarity.  However, the
proposed text is not quite right.  Possibly:

          rw  for configuration data- and choice nodes
          ro  for non-configuration data- and choice nodes,
              output parameters to rpcs and actions, and
              notification parameters

But maybe it is actually better to leave the original text, and go
through the entire document wrt terminology in a future update (if
necessary).  After all, the document is in AUTH48.


/martin



> /js
> 
> -- 
> Juergen Schoenwaelder           Jacobs University Bremen gGmbH
> Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
> Fax:   +49 421 200 3103         <https://www.jacobs-university.de/>
>