RE: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)

"Adrian Farrel" <adrian@olddog.co.uk> Wed, 10 July 2019 14:12 UTC

Return-Path: <adrian@olddog.co.uk>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2DC861200A1 for <ietf@ietfa.amsl.com>; Wed, 10 Jul 2019 07:12:07 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.596
X-Spam-Level:
X-Spam-Status: No, score=-2.596 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_NONE=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 HEL6B7vmc3oA for <ietf@ietfa.amsl.com>; Wed, 10 Jul 2019 07:12:04 -0700 (PDT)
Received: from mta8.iomartmail.com (mta8.iomartmail.com [62.128.193.158]) (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 BE9FD12002F for <ietf@ietf.org>; Wed, 10 Jul 2019 07:12:03 -0700 (PDT)
Received: from vs1.iomartmail.com (vs1.iomartmail.com [10.12.10.121]) by mta8.iomartmail.com (8.14.4/8.14.4) with ESMTP id x6AEC0lR008968; Wed, 10 Jul 2019 15:12:00 +0100
Received: from vs1.iomartmail.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id BE87222042; Wed, 10 Jul 2019 15:12:00 +0100 (BST)
Received: from asmtp2.iomartmail.com (unknown [10.12.10.249]) by vs1.iomartmail.com (Postfix) with ESMTPS id A8EAA2203D; Wed, 10 Jul 2019 15:12:00 +0100 (BST)
Received: from LAPTOPK7AS653V ([87.112.43.83]) (authenticated bits=0) by asmtp2.iomartmail.com (8.14.4/8.14.4) with ESMTP id x6AEBxpP020169 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Wed, 10 Jul 2019 15:12:00 +0100
Reply-To: adrian@olddog.co.uk
From: Adrian Farrel <adrian@olddog.co.uk>
To: 'Richard Barnes' <rlb@ipv.sx>, 'Randy Bush' <randy@psg.com>
Cc: 'Julian Reschke' <julian.reschke@gmx.de>, 'IETF Rinse Repeat' <ietf@ietf.org>
References: <20190704140552.GE49950@hanna.meerval.net> <b0943792-1afc-0c94-51b7-f2d393ef39c5@network-heretics.com> <20190705205723.GI55957@shrubbery.net> <20190706185415.GB14026@mit.edu> <CABcZeBPgNr5UqQ0pLwwNu5wh0g9L9wCd6YyYKCUDO37SPru-_Q@mail.gmail.com> <20190708202612.GG60909@shrubbery.net> <9ae14ad1-f8d5-befb-64e4-fff063c88e02@network-heretics.com> <CABcZeBOH9LH8Jrz-A5eu9arqUb+bx8xs_eKWi0pyoh7a3qpOPA@mail.gmail.com> <20190708223350.GO3508@localhost> <af3b25d6-af16-a96a-c149-61d01afb4d01@network-heretics.com> <20190708233438.GP3508@localhost> <ea0b9894-ae9d-55a9-a082-af7aac5be66a@huitema.net> <944332dc-bb2a-0717-8b9f-254b036fe59f@gmx.de> <m2pnmingsi.wl-randy@psg.com> <CAL02cgTBL7w02sWx4kaqGLQe8bGm4jRMyMY9v7yJw57_Sp=PgA@mail.gmail.com>
In-Reply-To: <CAL02cgTBL7w02sWx4kaqGLQe8bGm4jRMyMY9v7yJw57_Sp=PgA@mail.gmail.com>
Subject: RE: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)
Date: Wed, 10 Jul 2019 15:11:58 +0100
Organization: Old Dog Consulting
Message-ID: <013801d53729$708c5710$51a50530$@olddog.co.uk>
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="----=_NextPart_000_0139_01D53731.D251A970"
X-Mailer: Microsoft Outlook 16.0
Thread-Index: AQJlaergxW4qw2sgpGyAcJbqfeT4EAGVVY9iAdSbSmwBvedPDgMHEd8zAq94p3UB30aYiAG+gdBPAqvgpjMCAfpeiwFnK/0IAhmgKzUBtHjjHQLiglvDAP0xNPWkwYPJEA==
Content-Language: en-gb
X-Originating-IP: 87.112.43.83
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-24750.007
X-TM-AS-Result: No--21.830-10.0-31-10
X-imss-scan-details: No--21.830-10.0-31-10
X-TMASE-Version: IMSVA-9.0.0.1623-8.2.1013-24750.007
X-TMASE-Result: 10--21.830200-10.000000
X-TMASE-MatchedRID: 8HTFlOrbAtHoSitJVour/YM+duTM8cP1aMmm586o4gCvW5VplQp1rxyM EQgHZkVScEp+Z6/5wb8fSnaKIL6/H9qKXb5+iKNkqRcLlxSR3AUdLjiwtocA8t2dTMKvmfH+2ei 8YMtWyGA2muOXUVATZtjsjwLivckj7AEuIOP8dzOVUcz8XpiS9Erh/hn4JkBnRjNrjV0arFKjNt 7yPrwEDZDV+hi+9MGmDCYQOiCyrLSMazooQ1DaTPgAhuaFie7SWw/S0HB7eoNGpg/nZAuJ/cP2J GP0sgzGCIXseL5timCmj4XPy3K744QWpzpPGu4YVhgSdEkekv1kAa0IkTbdiCoBmWjkLcuLyIk9 0ea0myiOjdrR/sqiEWC3/wcdobwwPg9yfk4YC0aa+cpJvTbSHEyQ5fRSh265Et/W/Pt5w8df2kd uZxqSTI4z1C7DcWmDxTRAfhh1jQUOJgJ+hMX9jmCpu+NlpSDepzWK8AXDsxBH7rX2ckGqtVdKM2 MemW5vBM/ZNVWq/0oJZFkWy3fCQEBB4uOMf6t06qrX9V+kFlPSJHcOn8eY7iNGK7UC7ElMSuDPv wBGGIg22uoEm245flgUFTT7Y9QpYTZ2mX+nxwwItCy6ZX/lL4IWSprjdsebHCP6WbPscS8wfkn2 bVbTj4vfSJuNTN/rxWGby5Hg6eAsS7de5tK9ATE06wHA1+f+AcGk+q40InQXM2Z1UyweuO/JKo6 3i0vVLPtrQd14tHtQ0ON3ZFt2uSwwtxRkxyN3i+m1DDPm2yLBIlxtEe6gxzdHHXXKh5RC3yZ/GJ mw8EZG3VTLqEjHwUMXwyXg6HO8319rGX8jiaGeAiCmPx4NwGmRqNBHmBve1B0Hk1Q1KyLr8uVzX avvg4QViJlGwPJ1MigCzn3tPY89x+wZ8CT+fRsiCs5YA+JV8d5rNH2oahhto8BH8uZejg==
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/ietf/EauKnBX8AZKGN7fBENVD5HxcD1E>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 10 Jul 2019 14:12:07 -0000

Is it really that hard?

Even crusty old idiots like me have worked out how to use an editor to make XML that is acceptable to XML2RFC. I doubt that I am clever or more talented than Fellows of major engineering organizations.

All tools (even github) require to be learned.

 

Replace tools with better tools, by all means.

But don’t make changes for personal preference: that way lies unending debates about whose preference is best.

 

Thanks,

Adrian

 

From: ietf <ietf-bounces@ietf.org> On Behalf Of Richard Barnes
Sent: 10 July 2019 14:57
To: Randy Bush <randy@psg.com>
Cc: Julian Reschke <julian.reschke@gmx.de>; IETF Rinse Repeat <ietf@ietf.org>
Subject: Re: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)

 

I'm glad it works for you.  The non-IETF-habituated new authors I've worked with have found it mystifying.  Including everyone from junior engineers to Fellows of major engineering organizations.

 

As Christian says, our continued attachment to bespoke tools is a barrier to getting new work in the IETF, and thus detrimental to the long-term health of the organization.

 

--RLB

 

 

On Wed, Jul 10, 2019 at 9:47 AM Randy Bush <randy@psg.com <mailto:randy@psg.com> > wrote:

>> Tooling is just one of the problems with XML2RFC. The real issue is
>> that XML2RFC is completely specific to the IETF. This translate into
>> training ...
> It also has been optimized for the production of RFCs. Also note that
> many changes in the v3 vocab just align the language with HTML (lists
> and tables come to mind).

from an xml non-lover:

xml2rfc rocks!  it produces the baroqe, designed by committee, internet
draft format from input which i can easily produce in my text editor.

and the support, maintenance, and responsiveness of the tools team is
simply stunning.

[ and for the poster who wished for a gooey, there is one ]

thank you!

randy