Re: [Tools-discuss] Why do we even have text formats any more?

Carsten Bormann <cabo@tzi.org> Wed, 28 July 2021 07:33 UTC

Return-Path: <cabo@tzi.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 699A53A216E for <tools-discuss@ietfa.amsl.com>; Wed, 28 Jul 2021 00:33:35 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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 jvw9CC8ZTQ2Z for <tools-discuss@ietfa.amsl.com>; Wed, 28 Jul 2021 00:33:31 -0700 (PDT)
Received: from gabriel-smtp.zfn.uni-bremen.de (gabriel-smtp.zfn.uni-bremen.de [134.102.50.15]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 14B123A216D for <tools-discuss@ietf.org>; Wed, 28 Jul 2021 00:33:30 -0700 (PDT)
Received: from smtpclient.apple (p548dcc89.dip0.t-ipconnect.de [84.141.204.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-smtp.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4GZQPg31nGz2xLr; Wed, 28 Jul 2021 09:33:27 +0200 (CEST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <14bd112c-fd34-44ce-dcbc-9f3b989cdd7d@nostrum.com>
Date: Wed, 28 Jul 2021 09:33:26 +0200
Cc: tools-discuss@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <24E8E5F1-0492-49F8-8BA5-5A3E8D246BEC@tzi.org>
References: <4d70a1ac-a275-420a-83f6-99dfd5b5385c@www.fastmail.com> <14bd112c-fd34-44ce-dcbc-9f3b989cdd7d@nostrum.com>
To: Robert Sparks <rjsparks@nostrum.com>
X-Mailer: Apple Mail (2.3654.120.0.1.13)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/qwnC3kdtBYDfWG2wAD3yZ9lXmiU>
Subject: Re: [Tools-discuss] Why do we even have text formats any more?
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: Wed, 28 Jul 2021 07:33:35 -0000

On 28. Jul 2021, at 04:22, Robert Sparks <rjsparks@nostrum.com> wrote:
> 
> And finally, to your footnote, raising "why aren't people submitting XML?" - I've seen recently that there is fear from some seasoned submitters that the processor at the datatracker will get the references wrong. This is tied up with working in v2 and the issues we are working to correct with bibxml generation. Mitigating that fear will have an impact on the xml submission rate, I think.

Until recently, submitting TXT was the easy way to work around the mistreatment of hybrid XML by the submission process(*).
It will take some time until that gets out of people’s head.

The htmlizer did a mostly useful service for v2 users that the HTML output did not have: Adding links for section references.
V3 can now do that, but it requires conscious keyboarding(**); htmlizer completely automated that (but got it wrong occasionally).

I wrote a small PoC for a database of places where htmlizer gets it wrong with the necessary substitutions.
The cognitive barrier that v2 is obsolete might prevent that feature from happening.

Grüße, Carsten

(*) People used to submit TXT for most of the life of the I-D repository.
Then it became possible to submit XML along with that, which didn’t add anything except for archiving the XML as well.
But when the submission process started rejecting or mishandling submissions because XML came with them, everybody learned that it is a bad idea to send the XML, and TXT it was, again.

(**) Of course, in kramdown-rfc,

  Section 4.2.1 of {{RFC8949}}

simply becomes

  {{Section 4.2.1 of RFC8949}}

but for people keyboarding XML, manually adding section references is a bit more nightmarish:

From a recent AUTH48 (which still forces me to get in contact with XML):
     <t>IANA has created a new "<xref section="SenML Features" sectionFormat="bare" target="IANA.SENML"
     relative="#senml-features"/>" subregistry within
     the "Sensor Measurement Lists (SenML)" registry <xref target="IANA.SENML" format="default"/> with the

I can’t blame people who don’t want to make that effort.