Re: [netmod] WG adoption poll draft-kwatsen-netmod-artwork-folding-08

"Adrian Farrel" <adrian@olddog.co.uk> Tue, 23 October 2018 16:57 UTC

Return-Path: <adrian@olddog.co.uk>
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 D5B471277D2 for <netmod@ietfa.amsl.com>; Tue, 23 Oct 2018 09:57:34 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Level:
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, 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 XK_RDVq3ALfB for <netmod@ietfa.amsl.com>; Tue, 23 Oct 2018 09:57:32 -0700 (PDT)
Received: from mta6.iomartmail.com (mta6.iomartmail.com [62.128.193.156]) (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 DC651124C04 for <netmod@ietf.org>; Tue, 23 Oct 2018 09:57:31 -0700 (PDT)
Received: from vs3.iomartmail.com (vs3.iomartmail.com [10.12.10.124]) by mta6.iomartmail.com (8.14.4/8.14.4) with ESMTP id w9NGvTiJ006174; Tue, 23 Oct 2018 17:57:29 +0100
Received: from vs3.iomartmail.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 1955D2203C; Tue, 23 Oct 2018 17:57:29 +0100 (BST)
Received: from asmtp1.iomartmail.com (unknown [10.12.10.248]) by vs3.iomartmail.com (Postfix) with ESMTPS id 0401B2203A; Tue, 23 Oct 2018 17:57:29 +0100 (BST)
Received: from 950129200 (93.238.180.159.in-addr.arpa.celeste.fr [159.180.238.93] (may be forged)) (authenticated bits=0) by asmtp1.iomartmail.com (8.14.4/8.14.4) with ESMTP id w9NGvR0a020573 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 23 Oct 2018 17:57:28 +0100
Reply-To: adrian@olddog.co.uk
From: Adrian Farrel <adrian@olddog.co.uk>
To: 'Martin Bjorklund' <mbj@tail-f.com>, lhotka@nic.cz
Cc: netmod@ietf.org
References: <326034f9a137b0489137bc39616d166f221e02a2.camel@nic.cz> <20181023.162748.209178731500337122.mbj@tail-f.com> <27cbd2fe3dd114e981fce2abb1723c5115550142.camel@nic.cz> <20181023.180334.1196557244986533615.mbj@tail-f.com>
In-Reply-To: <20181023.180334.1196557244986533615.mbj@tail-f.com>
Date: Tue, 23 Oct 2018 17:57:27 +0100
Message-ID: <07d201d46af1$7b3e73a0$71bb5ae0$@olddog.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Outlook 14.0
Content-Language: en-gb
Thread-Index: AQHFLrQQRZs9sV6HgZ8otnhosGF7lQCluF6MAUfbku4BrHbt8aUuszFg
X-Originating-IP: 159.180.238.93
X-Thinkmail-Auth: adrian@olddog.co.uk
X-TM-AS-GCONF: 00
X-TM-AS-Product-Ver: IMSVA-9.0.0.1623-8.2.0.1013-24176.001
X-TM-AS-Result: No--29.014-10.0-31-10
X-imss-scan-details: No--29.014-10.0-31-10
X-TMASE-Version: IMSVA-9.0.0.1623-8.2.1013-24176.001
X-TMASE-Result: 10--29.014000-10.000000
X-TMASE-MatchedRID: gTucSmrmRMPxIbpQ8BhdbKfXIl6Cf6VrGSqdEmeD/nXb6Y+fnTZUL6oK U9R7erGEXSjU4/YC0T3xTwx4UJIMcsSsicU7ThvNlVHM/F6YkvTp8lxWp2elloehsWfaDKtkL3P LMlQSdmQHG4nQZY11VsD0U79tKMTN2krzNcCKFT60sO72q2op4V4UPVYgPLUua0TOsL14A2nn0L pDrddNEq4FOedMHR6MEp+NNlyzaQoBpTIFsSiyLWivjLE8DPtZGFwEGDRX5uwQRik6+J7XSbnnq KtFdBFdsDgwFBBNhzyVWH1eq874X48iv1am7RhcV6iWWmDPLECz5LIh2+IOfB0bKcI3i70lr0pc boGSwNfIU5qoQRkBH3jPHbHXDRMc/0j7XSCRjJCM29hkek7XdyseSAhqf1rRqPm/sjj9KBiy1Vq a24VemeoitjXqQyUzeVO+e3Uxwfrw2L2r2UxibLttJwl7IC+WGK57kZ/2makPVb41Wr4BJ8it/e CfvDyi+D4/c8pyvfr5fIu2trOcXXyvvbPeypnpIaqnBNB240JflOpBqBHTtxUb9+x7ts88mGfxH Y10dzsQSK75DSbBzubGqBsFMykQQ9tg+p38ZolmVHNo7XGkneiOwn7Nhoo1d6RFRE7vKfE4XUyA 5KW+eAiG/bAuct2gYnAKxv9nxqVNfs8n85Te8v7E6GNqs6ce/W9MYGK5mu1TZDOrzlZ+cHQdJ7X fU86e4kYXbobxJbLnIzRzWS2P0w==
X-TMASE-SNAP-Result: 1.821001.0001-0-1-12:0,22:0,33:0,34:0-0
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/7qaA0SMTDMxgtSkfeG5zgimYCMA>
Subject: Re: [netmod] WG adoption poll draft-kwatsen-netmod-artwork-folding-08
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
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, 23 Oct 2018 16:57:35 -0000

Nicely said, Martin.
The intention is that if, like Ladislav, you like to work in some long-line
format, then it works as documented and the tools can wrap.
If, like me, and maybe like Martin, you think pretty formatting is something
that improves readability, the draft also lets you do that.

A

> -----Original Message-----
> From: Martin Bjorklund [mailto:mbj@tail-f.com]
> Sent: 23 October 2018 17:04
> To: lhotka@nic.cz
> Cc: adrian@olddog.co.uk; netmod@ietf.org
> Subject: Re: [netmod] WG adoption poll draft-kwatsen-netmod-artwork-folding-
> 08
> 
> Ladislav Lhotka <lhotka@nic.cz> wrote:
> > On Tue, 2018-10-23 at 16:27 +0200, Martin Bjorklund wrote:
> > > Ladislav Lhotka <lhotka@nic.cz> wrote:
> > > > On Tue, 2018-10-23 at 14:45 +0100, Adrian Farrel wrote:
> > > > > Hi,
> > > > >
> > > > > 1. I think you miss the point. While example XML/JSON YANG is included
> in
> > > > > drafts, and while the authors are allowed to produce those drafts as
txt
> > > > > files,
> > > > > or while the authors want to achieve pretty-to-read formatting, this
work
> > > > > falls
> > > > > into the scope of those authors.
> > > >
> > > > The folding of long lines should be done as the very last (automatic)
step
> > > > before the document gets published. Doing it earlier means that the
source
> > > code
> > > > in this folded form can be (accidentally) further edited, which can lead
to
> > > > inconsistencies.
> > >
> > > I will use folding e.g. for instance document examples in XML and
> > > JSON.
> > >
> > > My plan is to keep the example files with manually added breaks in my
> > > repo, and as part of validation run a script that unfolds the
> > > examples, and then validate the result.  The reason for this is that I
> > > think readbility of the examples is important.
> >
> > This seems backwards to me. If you need to edit such an example, you may
> have to
> > remove the backslashes, reformat and insert them again.
> >
> > If it's not possible to fold lines according to the syntax of a given
language,
> > I'd prefer to keep the original lines as long as possible and rely on an
> > automatic procedure just before the final document is rolled out.
> 
> Fortunately, the draft allows us both to work the way we prefer.
> 
> 
> /martin
> 
> 
> >
> > Lada
> >
> > >
> > >
> > > /martin
> > >
> > >
> > >
> > > >
> > > > As long as the document is being moved around and edited, it would be
> better
> > > to
> > > > keep the source code untouched.
> > > >
> > > > Lada
> > > >
> > > > >
> > > > > 2. Yes, the authors discussed the <sourcecode> element and agreed that
> it
> > > will
> > > > > be in scope.
> > > > >
> > > > > However, we are all sort of waiting for xml2rfc v3 and pending
completion,
> > > we
> > > > > want to move this forward for v2 that is in use today.
> > > > >
> > > > > (More than) Happy to come back and revisit this issue when v3 is
> deployed.
> > > > >
> > > > > Thanks,
> > > > > Adrian
> > > > >
> > > > > > -----Original Message-----
> > > > > > From: netmod [mailto:netmod-bounces@ietf.org] On Behalf Of Ladislav
> > > Lhotka
> > > > > > Sent: 23 October 2018 14:24
> > > > > > To: netmod@ietf.org
> > > > > > Subject: Re: [netmod] WG adoption poll draft-kwatsen-netmod-
> artwork-
> > > folding-
> > > > > > 08
> > > > > >
> > > > > > On Tue, 2018-10-23 at 14:40 +0200, Ladislav Lhotka wrote:
> > > > > > > Hi,
> > > > > > >
> > > > > > > I support the adoption.
> > > > > > >
> > > > > > > Comments:
> > > > > > >
> > > > > > > 1. My general feeling is that such technicalities should be
handled by
> > > > > > >    the RFC editor and/or tools rather than YANG module and RFC
> > > authors.
> > > > > > >
> > > > > > > 2. xml2rfc v3 introduced a new element, <sourcecode>, that is
> intended
> > > > > > >    for source code inclusion. This document should therefore cover
> > > this
> > > > > > >    element as well (primarily?). One problem with it is that the
> > > xml2rfc
> > > > > > >    tool automatically adds the <CODE BEGINS> and <CODE ENDS>
> markers,
> > > > > > >    which interferes with YANG convention specified in RFC 8407,
> > > > > > >    sec. 3.2. I have already raised a question about this in the
> > > > > > >    xml2rfc-dev mailing list.
> > > > > >
> > > > > > Update: using the "name" attribute with <sourcecode> does the right
> > > thing.
> > > > > >
> > > > > >     <sourcecode name="ietf-foo@2016-03-20.yang">
> > > > > >     ...
> > > > > >     </sourcecode>
> > > > > >
> > > > > > results in
> > > > > >
> > > > > >     <CODE BEGINS> file "ietf-foo@2016-03-20.yang"
> > > > > >     ...
> > > > > >     <CODE ENDS>
> > > > > >
> > > > > > Lada
> > > > > >
> > > > > > > Lada
> > > > > > >
> > > > > > > Lou Berger <lberger@labn.net> writes:
> > > > > > >
> > > > > > > > All,
> > > > > > > >
> > > > > > > > This is start of a two week poll on making
> > > > > > > > draft-kwatsen-netmod-artwork-folding-08 a working group
> > > > > > > > document. Please send email to the list indicating "yes/support"
or
> > > > > > > > "no/do not support".  If indicating no, please state your
> > > reservations
> > > > > > > > with the document.  If yes, please also feel free to provide
> > > comments
> > > > > > > > you'd like to see addressed once the document is a WG document.
> > > > > > > >
> > > > > > > > The poll ends Oct 1.
> > > > > > > >
> > > > > > > > Thanks,
> > > > > > > >
> > > > > > > > Lou (and co-chairs)
> > > > > > > >
> > > > > > > > _______________________________________________
> > > > > > > > netmod mailing list
> > > > > > > > netmod@ietf.org
> > > > > > > > https://www.ietf.org/mailman/listinfo/netmod
> > > > > > --
> > > > > > Ladislav Lhotka
> > > > > > Head, CZ.NIC Labs
> > > > > > PGP Key ID: 0xB8F92B08A9F76C67
> > > > > >
> > > > > > _______________________________________________
> > > > > > netmod mailing list
> > > > > > netmod@ietf.org
> > > > > > https://www.ietf.org/mailman/listinfo/netmod
> > > > --
> > > > Ladislav Lhotka
> > > > Head, CZ.NIC Labs
> > > > PGP Key ID: 0xB8F92B08A9F76C67
> > > >
> > > > _______________________________________________
> > > > netmod mailing list
> > > > netmod@ietf.org
> > > > https://www.ietf.org/mailman/listinfo/netmod
> > > >
> > --
> > Ladislav Lhotka
> > Head, CZ.NIC Labs
> > PGP Key ID: 0xB8F92B08A9F76C67
> >