Re: [Tools-discuss] [rfc-i] Proposed survey on I-D authoring tools

Jay Daley <jay@ietf.org> Thu, 01 October 2020 16:13 UTC

Return-Path: <jay@ietf.org>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B2E4D3A0C00 for <tools-discuss@ietfa.amsl.com>; Thu, 1 Oct 2020 09:13:04 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Level:
X-Spam-Status: No, score=-1.898 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=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 3QSvhExqw2xV; Thu, 1 Oct 2020 09:13:03 -0700 (PDT)
Received: from jays-mbp.localdomain (unknown [158.140.230.105]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPSA id D70293A0B93; Thu, 1 Oct 2020 09:13:02 -0700 (PDT)
From: Jay Daley <jay@ietf.org>
Message-Id: <DBCBE873-ACFA-423D-8ABF-9D4DEBF1AFAB@ietf.org>
Content-Type: multipart/alternative; boundary="Apple-Mail=_5B32E3BA-2254-44FE-A0E7-DEF703BEDF26"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\))
Date: Fri, 02 Oct 2020 05:13:00 +1300
In-Reply-To: <m2h7rendtv.wl-randy@psg.com>
Cc: rfc-interest@rfc-editor.org, Tools Discussion <tools-discuss@ietf.org>
To: Randy Bush <randy@psg.com>
References: <71CCD4C4-2CBA-4AD3-A254-2F19B261D882@ietf.org> <m2lfgqq2ww.wl-randy@psg.com> <1071F4D3-3F36-4012-9CBB-19DDDE6D0564@ietf.org> <m2h7req25a.wl-randy@psg.com> <9F1ABBE7-DC90-4C3C-8493-E89243C73C4C@ietf.org> <m24knepwg4.wl-randy@psg.com> <A62BA403-01EC-4142-A91C-6E675C1E1942@ietf.org> <19017.1601561002@localhost> <m2h7rendtv.wl-randy@psg.com>
X-Mailer: Apple Mail (2.3608.120.23.2.1)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/uREuQcXyM1ACRveDtmFIn80ogY0>
Subject: Re: [Tools-discuss] [rfc-i] Proposed survey on I-D authoring tools
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 01 Oct 2020 16:13:05 -0000


> On 2/10/2020, at 4:52 AM, Randy Bush <randy@psg.com> wrote:
> 
> i started to wonder two things
> 
> what is all this about?  who actually wants this survey and why?

It started with an action I took in the most recent RSOC meeting to survey authors to understand choices on draft submission formats because those directly affect the work of the RPC which in turn affects the SLA and the contract cost.  The adoption of the v3 XML as the RFC publication format in September 2019 has meant a significant increase in costs as the RPC has to convert plain text or v2 XML submissions into v3.

In that context I was surprised to hear that a number of people author in XML and then use xml2rfc to convert to plain text and submit that plain text I-D.

After my first draft it became clear that this had to loop in the tools teams as the survey could not focus on formats without also covering tools as the two are so closely linked.

> 
> and, as you started it, jay, i wonder what toolchain you use to author
> drafts?

The last time I authored a draft was in 2013 and I wrote that in XML using the OxygenXML commercial XML editor with xml2rfc to validate it. I don’t remember what format I used to submit it.  That draft btw was all about XML/XSLT.  https://datatracker.ietf.org/person/Jay%20Daley

Jay


> 
> randy
> 

-- 
Jay Daley
IETF Executive Director
jay@ietf.org