Re: [netmod] choice/case in tree diagrams

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Tue, 06 March 2018 15:24 UTC

Return-Path: <j.schoenwaelder@jacobs-university.de>
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 A7BB812706D for <netmod@ietfa.amsl.com>; Tue, 6 Mar 2018 07:24:06 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, 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 IAn-079vKiC7 for <netmod@ietfa.amsl.com>; Tue, 6 Mar 2018 07:24:05 -0800 (PST)
Received: from atlas5.jacobs-university.de (atlas5.jacobs-university.de [212.201.44.20]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 1230A120454 for <netmod@ietf.org>; Tue, 6 Mar 2018 07:24:05 -0800 (PST)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas5.jacobs-university.de (Postfix) with ESMTP id D1499D00; Tue, 6 Mar 2018 16:24:03 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas5.jacobs-university.de ([10.70.0.217]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10032) with ESMTP id zdtLKk3JgBjG; Tue, 6 Mar 2018 16:24:02 +0100 (CET)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hermes.jacobs-university.de", Issuer "Jacobs University CA - G01" (verified OK)) by atlas5.jacobs-university.de (Postfix) with ESMTPS; Tue, 6 Mar 2018 16:24:03 +0100 (CET)
Received: from localhost (demetrius1.jacobs-university.de [212.201.44.46]) by hermes.jacobs-university.de (Postfix) with ESMTP id AA7A220160; Tue, 6 Mar 2018 16:24:03 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius1.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id NXnkrwyupJRS; Tue, 6 Mar 2018 16:24:03 +0100 (CET)
Received: from elstar.local (unknown [10.50.231.133]) by hermes.jacobs-university.de (Postfix) with ESMTP id 27F7320158; Tue, 6 Mar 2018 16:24:03 +0100 (CET)
Received: by elstar.local (Postfix, from userid 501) id B283842650E1; Tue, 6 Mar 2018 16:24:02 +0100 (CET)
Date: Tue, 06 Mar 2018 16:24:02 +0100
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Martin Bjorklund <mbj@tail-f.com>
Cc: vladimir@transpacket.com, netmod@ietf.org
Message-ID: <20180306152402.3fdvvqupbovcl2rg@elstar.local>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: Martin Bjorklund <mbj@tail-f.com>, vladimir@transpacket.com, netmod@ietf.org
References: <20180306124825.joukx2lvszeehrzt@elstar.local> <20180306.140023.524272795634334481.mbj@tail-f.com> <20180306133604.cdttv22mrjci5tnw@elstar.local> <20180306.154549.756915470498081734.mbj@tail-f.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <20180306.154549.756915470498081734.mbj@tail-f.com>
User-Agent: NeoMutt/20171215
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/g_7NruVrBabXo8eTIC5M8yVVkoI>
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 15:24:07 -0000

On Tue, Mar 06, 2018 at 03:45:49PM +0100, Martin Bjorklund wrote:
> 
> 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
>

Good.

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

I do not agree. 'data' is entirely undefined - it means nothing. How
do I know that 'data' includes 'choice nodes'? I think we better fix
this here.

I agree that a general careful check of terminology should be done in
an update but I do not see why AUTH48 says we should not fix the
problem that was discovered. And for me, a fix is not a fix if things
are left ambiguous.

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