IETF Logo Mail Archive

Re: [netmod] tree diagrams - flags

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Tue, 21 March 2017 16:28 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 30E2D129B9A for <netmod@ietfa.amsl.com>; Tue, 21 Mar 2017 09:28:27 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Level:
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RP_MATCHES_RCVD=-0.001, URIBL_BLOCKED=0.001] 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 Jt0rtbbbCJqy for <netmod@ietfa.amsl.com>; Tue, 21 Mar 2017 09:28:25 -0700 (PDT)
Received: from atlas3.jacobs-university.de (atlas3.jacobs-university.de [212.201.44.18]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 11B52129B94 for <netmod@ietf.org>; Tue, 21 Mar 2017 09:28:22 -0700 (PDT)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas3.jacobs-university.de (Postfix) with ESMTP id DEE0211FC; Tue, 21 Mar 2017 17:28:20 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas3.jacobs-university.de ([10.70.0.205]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10030) with ESMTP id HmsO8txpHi16; Tue, 21 Mar 2017 17:28:19 +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 atlas3.jacobs-university.de (Postfix) with ESMTPS; Tue, 21 Mar 2017 17:28:20 +0100 (CET)
Received: from localhost (demetrius4.jacobs-university.de [212.201.44.49]) by hermes.jacobs-university.de (Postfix) with ESMTP id 96FB62002B; Tue, 21 Mar 2017 17:28:20 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius4.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id hEt5s7gL_kGY; Tue, 21 Mar 2017 17:28:19 +0100 (CET)
Received: from elstar.local (elstar.jacobs.jacobs-university.de [10.50.231.133]) by hermes.jacobs-university.de (Postfix) with ESMTP id 7A13C20038; Tue, 21 Mar 2017 17:28:19 +0100 (CET)
Received: by elstar.local (Postfix, from userid 501) id 5E8F13EF24F7; Tue, 21 Mar 2017 17:28:23 +0100 (CET)
Date: Tue, 21 Mar 2017 17:28:22 +0100
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Ladislav Lhotka <lhotka@nic.cz>
Cc: Robert Wilton <rwilton@cisco.com>, netmod@ietf.org
Message-ID: <20170321162822.GA36653@elstar.local>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: Ladislav Lhotka <lhotka@nic.cz>, Robert Wilton <rwilton@cisco.com>, netmod@ietf.org
References: <20170321102533.GC35449@elstar.local> <05D066C2-08AA-4140-9399-87654141F821@nic.cz> <70eb5dec-2b98-5e14-0150-0ee3e55ae99f@cisco.com> <E8B217D8-9961-49ED-B035-D16CDE957270@nic.cz> <20170321141123.GB35926@elstar.local> <628D63D4-0250-4150-BE2A-F90298499473@nic.cz>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <628D63D4-0250-4150-BE2A-F90298499473@nic.cz>
User-Agent: Mutt/1.6.0 (2016-04-01)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/fRATEPqCELwdLjQQgYLR5EGC7EY>
Subject: Re: [netmod] tree diagrams - flags
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, 21 Mar 2017 16:28:27 -0000

On Tue, Mar 21, 2017 at 04:55:18PM +0100, Ladislav Lhotka wrote:
> 
> > 
> > Single character flags work for me as well. Since I have modules with
> > pretty complex RPC inputs (more than a single page in RFC formatting),
> > I think it is useful to be able to see that one is still starting at
> > an RPC input tree and not a regular data tree or a notification tree.
> 
> Even with long RPC parameter lists the indentation should make it obvious what belongs where. Another option might be to label every input parameter with "xi" or "i" and output with "xo"/"o", and remove the "input" and "output" nodes. This would make the output shorter and narrower.
>

I wrote multiple pages - indentation is difficult to follow over page
boundaries.

> > So I tend to like Rob's proposal a bit more.
> 
> Note however that Rob's proposal doesn't distinguish input and output parameters, all are labelled with "x".
>

I know. At least I know I am still in an rpc/action definition. But
yes, some of this may be personal preference.

/js

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

v2.23.0 | Report a Bug | By Email