Re: [Rfc-markdown] No longer need to run xml2rfc --v2v3 before I-D submission

Julian Reschke <julian.reschke@gmx.de> Wed, 28 July 2021 10:41 UTC

Return-Path: <julian.reschke@gmx.de>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 29E973A0317 for <rfc-markdown@ietfa.amsl.com>; Wed, 28 Jul 2021 03:41:54 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=gmx.net
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 kybQS2mOf8Tv for <rfc-markdown@ietfa.amsl.com>; Wed, 28 Jul 2021 03:41:49 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.21]) (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 1B7F43A02C1 for <rfc-markdown@ietf.org>; Wed, 28 Jul 2021 03:41:48 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1627468902; bh=r24jEgW4jKeVn3c873Aa1fnOb3ZXu5nRoczGWmHVKEU=; h=X-UI-Sender-Class:Subject:To:References:From:Date:In-Reply-To; b=PK4eRju0Mdv5vt9z1Y/QTDNYUQd/FU9abCahw+raB4Q7Rxmy+zTeo5lJ1df9Eamxt f1N9X5AMhDtLLTViGYFH1EuGGcIRQot/tUYUvhHq7ya0Mq/d3N6X+wf+S+iUlPN3G6 E5od+Bf/w+SjltgoffastnsHHR8i4nQmhGguYU10=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [172.16.16.44] ([212.205.152.82]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MJVHU-1mSZJ80z1M-00JtqV for <rfc-markdown@ietf.org>; Wed, 28 Jul 2021 12:41:42 +0200
To: rfc-markdown@ietf.org
References: <20210712034838.B461E209AFFB@ary.qy> <6c781dab-7a40-7031-be1c-d77a182f4cf4@gmail.com> <DE0CD982-D4BE-44A6-9234-B53A756E9717@mnot.net> <bbb8302a-4041-35db-ce61-d2a18b8ebeee@taugh.com> <AB6E5013-C14E-4962-8907-17F241971F9D@tzi.org> <20210719171839.GB24216@faui48e.informatik.uni-erlangen.de> <DBCC4252-8A2D-473C-82CD-B1B2688586D3@tzi.org> <777A0822-6C16-4967-ABD0-BD35359B9FC5@tzi.org> <974739FF-7EB8-475B-A6A9-CB096D567E91@tzi.org> <10368632-F4A3-4876-A4F0-81C3DDBE002F@mnot.net> <F5519EBC-E453-4552-8B7F-F34425DAD2A1@tzi.org> <F15694DF-6ACD-469F-9CA9-E33C5FC03223@mnot.net> <BC5E00A5-2FBF-45E4-985B-5E67935D3192@tzi.org> <078FD4CC-E219-43F5-8DCD-3C55D8ABEF6D@mnot.net> <9F805284-0053-4B5F-8F89-EF6B4BA48D4A@tzi.org> <7B98D0B6-0102-4CE4-B4D6-6FBA04033234@mnot.net> <48cd298c-5ac5-fd6f-19b5-b0117b683c19@gmx.de> <6D5AECC6-890F-4E89-B4DD-63A8EE6817FA@tzi.org>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <facaaaeb-fe69-a1d0-7af6-19f05b41d0a1@gmx.de>
Date: Wed, 28 Jul 2021 12:41:42 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.12.0
MIME-Version: 1.0
In-Reply-To: <6D5AECC6-890F-4E89-B4DD-63A8EE6817FA@tzi.org>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:v1CvrZCP/Y9W4E5+PrRis5/RpNqwQutFu4xBIaUxEyKJBVc/D4J aX9ZY9eOsdSMRrIsjEp3OhzEPStiIDZVeLNlTsEbb1lVO/E8HNE1ed2hbmhN0/YzTgEyWg9 +7y4MMOlf5+R7FmBvmznccr1c9bBdl3CPg7X4zI/8emXoo72N/CLQf1GwVn7cDmZUn+Xw/I AN1EjZAUuQ5IvivbOu0iw==
X-UI-Out-Filterresults: notjunk:1;V03:K0:sBPGnTkPYqc=:3hmqRVwpysQlMkSKPUtiYx VNNZ+lb5hSX9A4WATJQpk6B8HITaRAWpMewUd/4IJ/RzcfL7Es1wutfEpkxzPLELogWFLAz2c 3RvIa3UVxk9abwtKT4LS0+jKswE2ExikPuCDArq+7Le93mxEkAcGlCG/KsnttQjgoePsvLAb/ jWsbeucawGjYzOW7bNPjh905uR83mJ2ZQDAuPmhH1KQosSDyrThhGIW3BV9AcnYaxcNTanA3d NakqoVGN93XXRnvi3qDVxqAQjcK4lxZMVfq4rLGKmNChRCELd7Vvew0EHonpvIsQncWd/LWyA zmK0PurMJOdfDVUZp814zV5LLevWhD1qU5rYZAYemqkrE1uicr28HxY7f/a/dwQA8wMV2mMij CMxvqpHIapOJMkCfa7x4PpL88WGT5QjF0Sk5rYYKlRSHZhvxy+AxwP79GTZmikTabp+4/fZuF W3yBm3Z7QN2N3y+k1hLNQDOspOEwBMJraN4ZtgR8Ta61ocAFovp/Vq2hzamge5beAyCUMubt9 F0A0gwqJ1EO98C0kGxVlZArCiWS0AQKXAedl+4e8NTrnBSogMET7j1EoENkIePRhshfvIZ7Gr iqvIMnrygXl4Yxcf4eZsKmsUowvVGwz+bEA1s+XYUTouGXnxEocI3nqIx5g0ns6XlyHCrQ1Fn oGRJw9BsCnGX1faLW92gJJf/BDZTiRI3ih7r4HkhzFYcTrnu1x/TUZqslPtPm4kdk9631AAAU YBM+My/M7k3PBH1Ym4grIdu5es7THKz1+Zp88/fF37/A2u29gDUJf/hbuvFwVr4dpoQftGQVO U4mDrZi6J68XGJ7b1tq9WMa4aZ5FC2ip+1ODQesI/pfNNIZXqNnK4Wb7sF+TdCsnZBp9cEzdu R5nizvv01jC30ZQUJpM3CI/kt0lfrKIkaN8U0zZ5IDUnqf4fTPYRIMZBl+oeaB14fRHS6UZel A8Ud/AOuxLUGwr2YyfSUXvxF0t08hL9alw1pF+Cp9t4bQrBSwXT3wg8S2sKTP08nwo2nNTOGq JZ1ygkyEN035ik5MSekOn1JU3SsUjn+QwiXzW4FlVPtdEKIhm8d/O8Eulsucpz7+26DrwgG4z /txOdiyyIBtMEYWqrUDJMmAL8Y19QCyKv21IRxdm3wp1FJ9AtegOgSN8w==
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/hoIiTLp0cjlgeSPQ_RGsNt9IkVA>
Subject: Re: [Rfc-markdown] No longer need to run xml2rfc --v2v3 before I-D submission
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 28 Jul 2021 10:41:54 -0000

Am 28.07.2021 um 12:00 schrieb Carsten Bormann:
> On 2021-07-27, at 09:40, Julian Reschke <julian.reschke@gmx.de> wrote:
>>
>> Just stop generating v2 :-)
>
> There was a smiley here, but some people might take this at face value.
>
> As long as
>
>       <?rfc include="reference.RFC.2119”?>
>
> no longer works in v3, I’ll recommend people who can’t (*) convert to markdown to stay with v2 (preferably processed in hybrid mode).
> ...

Note I said "stop generating", as opposed to "stop authoring".

> This one specimen is, of course, just an example of how v2 was designed a little bit more for authors, while v3 is prioritizing a form of standards compliance that actually is not giving us anything on the author side.
>
> How is the below better than the above:
>
>      <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
>
> The v3 version encodes a URI that is brittle (you would probably already tell me that the authority component is wrong now, and the path name also is brittle).  It requires xi:include processing in any additional author-side tools.  And it is impossible to type from memory.

The fact that the URI is brittle is entirely the fault of the IETF. This
should have been fixed years ago. Cool URIs do not change.

My experience is that people copy & paste from existing documents or
references, so I really don't buy the "type from memory" argument.

The issue with the v2 PI is that is was never specified, and has
heuristics for document types wired in. Plus local caching. There's a
reason why a huge number of XML processed in AUTH48 before the switch
now does not compile anymore.

Yes, one could argue that for the common cases, a simpler syntax would
be nice. -> Feature request.

> I’m a German, so I do have the genes for excessive bureaucracy.
> But this…  No.
>
> Grüße, Carsten
>
> (*) You co-author might retire soon and this is “their last RFC”, so they don’t want to learn something new while they have ingrained RFCXMLv2 skill.  Or some such.

Then run through the converter, and edit from there?

Best regards, Julian