Re: [Gendispatch] Updating the IETF Discussion List Charter (was: Fwd: New Version Notification for draft-eggert-bcp45bis-02.txt)

Brian E Carpenter <brian.e.carpenter@gmail.com> Sun, 26 June 2022 22:04 UTC

Return-Path: <brian.e.carpenter@gmail.com>
X-Original-To: gendispatch@ietfa.amsl.com
Delivered-To: gendispatch@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7EBBAC157B32 for <gendispatch@ietfa.amsl.com>; Sun, 26 Jun 2022 15:04:28 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.985
X-Spam-Level:
X-Spam-Status: No, score=-3.985 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, NICE_REPLY_A=-1.876, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id eZbB0iUBqGFe for <gendispatch@ietfa.amsl.com>; Sun, 26 Jun 2022 15:04:27 -0700 (PDT)
Received: from mail-pg1-x535.google.com (mail-pg1-x535.google.com [IPv6:2607:f8b0:4864:20::535]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5BA88C14F75F for <gendispatch@ietf.org>; Sun, 26 Jun 2022 15:04:27 -0700 (PDT)
Received: by mail-pg1-x535.google.com with SMTP id d129so7391767pgc.9 for <gendispatch@ietf.org>; Sun, 26 Jun 2022 15:04:27 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=message-id:date:mime-version:user-agent:subject:content-language:to :cc:references:from:in-reply-to:content-transfer-encoding; bh=rOAcnwPOaWTsdiUZUKcmkw0MHsu07tGn3xCu7+vSGwI=; b=Pnyxjf0fuv4mnKbxEU5E+uMUzp21okDJVA1drX+af+WqXgKFoxzH/BRXVY8+V2Isxy nj3PcEY5RRZiX1g0PFQe/ILQprtZJ3eQvBzJ1nBKKc3G3vdAs/iTmqRNlm607RdQbiYj 1nMgEjNP7plh+KTf4yQ5xKgu9lVAKmtqzsQq50JRQ1wWyBeWqFJb5R7nI4I0b3kQS13I 97nbUiDoqO5rDxHTUPSF+YF20RtsXiLBJJaFR/wuORcjdjXfDUpMagVGeCcoX5e2IC8G S5yjHQhQXxACciouXtMDtFrK3EMM6h43mIq3DYGcaqYpSVC5Ni2OihDEBCOYlzLM/w6S rjUQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:date:mime-version:user-agent:subject :content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=rOAcnwPOaWTsdiUZUKcmkw0MHsu07tGn3xCu7+vSGwI=; b=MA6S/oiQxNZpnEh2sucxZIHuXRhAt4Yi7QcUd/NI8Y8K/8Cp5pZwpIF1A0mKiaUeYE R2vCVidqyfXONmfxY5XAZlZ7cDyY6sUTb3K6BAx+VXQw9vl/Zcr6nEeYC1MmuT6vZvkU 3TzMc1buAYWI7cAkKzMWAOymo4+AL/74nXa2f9mQNAKjFmgIGGnpsaDJd0khjtVRnrAb q/jYCPgi0hX+SMAS7R2Misusx7zwKEOogt+YQIxucQPH6I8GVAOnDtgepZ6ipWUZqAUZ 1io/t8GFN74pKE+B5VpS2/HYtNW+n3hzRcmiwiHFkB/4ADedglM+bTmYVqdZ2OcpXtoD 1VaA==
X-Gm-Message-State: AJIora80Mav53jw3YWzuOv6ensenku3ArU8UuBokQT0eBx0XPrHnTNvm LJYLqVIF1bQ9wp2H7u4i+Lc=
X-Google-Smtp-Source: AGRyM1v5DLfdmMeAUOooTiDyPDFDA7mLDclfQeBlkQTM+Uy2/E7HWudQCDAuKjn6HAL0JK2gxGsFIg==
X-Received: by 2002:a63:194c:0:b0:408:a9d1:400c with SMTP id 12-20020a63194c000000b00408a9d1400cmr9867675pgz.559.1656281066244; Sun, 26 Jun 2022 15:04:26 -0700 (PDT)
Received: from ?IPV6:2406:e003:1124:9301:80b2:5c79:2266:e431? ([2406:e003:1124:9301:80b2:5c79:2266:e431]) by smtp.gmail.com with ESMTPSA id i4-20020a17090332c400b0016a4db13435sm5622808plr.191.2022.06.26.15.04.23 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 26 Jun 2022 15:04:25 -0700 (PDT)
Message-ID: <aba0a4a3-c2df-7af2-6071-13b555b2153d@gmail.com>
Date: Mon, 27 Jun 2022 10:04:20 +1200
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101 Thunderbird/91.10.0
Content-Language: en-US
To: Keith Moore <moore@network-heretics.com>, Eric Rescorla <ekr@rtfm.com>, Joel Halpern <jmh@joelhalpern.com>
Cc: Barry Leiba <barryleiba@computer.org>, GENDISPATCH List <gendispatch@ietf.org>
References: <162444929705.22096.2956472779291079641@ietfa.amsl.com> <ED2832A3-F392-4F7F-8483-071140AB8FF6@eggert.org> <07736465-1FEB-4419-B6F5-B18ABB23865C@eggert.org> <CAChr6SzvXDxzi49ZG3oCJGVDh03iSOMgVVqj4EaOUM9TsJxFgQ@mail.gmail.com> <cfac3427-510b-fcf0-fdce-e1b3b7908a52@network-heretics.com> <bbafcb27-cf1d-665b-785c-137d4d20e2a9@cs.tcd.ie> <b5180ca1-f7a6-edfb-2ac6-31fe64ed88c1@lear.ch> <fe5062c6-0d70-1f03-9773-34e67c2b5e09@network-heretics.com> <CALaySJ+EofzQJFMqDhB_pYFoPXevjx_0+PKpQr+cyjhfTCX8-w@mail.gmail.com> <8cc9ff59-a07d-e34d-fd60-265ebb3560fd@network-heretics.com> <CABcZeBOJNtLqVC2+j=V8XKZtYmxmgnLmhSGhA-2BuKFzLzUE9Q@mail.gmail.com> <4da0a6f9-83ba-4c2a-2f02-0a7a5dcb627e@joelhalpern.com> <CABcZeBOW4DUp0OLkPbGpCVqf=Vz8FFTeT=A-c02isEHh1K9MVA@mail.gmail.com> <47a993e3-0d9b-9afa-2656-f7ea9d1b0bff@network-heretics.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
In-Reply-To: <47a993e3-0d9b-9afa-2656-f7ea9d1b0bff@network-heretics.com>
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: base64
Archived-At: <https://mailarchive.ietf.org/arch/msg/gendispatch/LtLZCPMbGDKx4G8X5JyVc6JEafY>
Subject: Re: [Gendispatch] Updating the IETF Discussion List Charter (was: Fwd: New Version Notification for draft-eggert-bcp45bis-02.txt)
X-BeenThere: gendispatch@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: General Area Dispatch <gendispatch.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gendispatch>, <mailto:gendispatch-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/gendispatch/>
List-Post: <mailto:gendispatch@ietf.org>
List-Help: <mailto:gendispatch-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gendispatch>, <mailto:gendispatch-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 26 Jun 2022 22:04:28 -0000

Keith,

On 27-Jun-22 09:18, Keith Moore wrote:
> On 6/26/22 17:12, Eric Rescorla wrote:
> 
>>     I would phrase it  a little differently.   If you use a working template using a preparation form you are comfortable with, it works pretty well.  Yes, there are some hoops to jump through.  For example, we need the copyright grant.
>>
>> I think this is generally accurate.
>>
>> Having written a number of drafts with xml2rfc and with kramdown->xml2rfc my experience is that xml2rfc has a number of mystery failure modes which are hard to diagnose. It's a lot easier to get into those states editing the xml directly because kramdown generally generates correct XML. However, if you do manage to get into such a state with kramdown it can be very hard to figure out what's going on!
> 
> Is there a way to skip xml2rfc entirely?  IMO that's the biggest part of the problem.   I can accept the utility of XML for an RFC that needs to be maintained for a long time, but I'm not at all sure it's worth the trouble for a -00 Internet-Draft.   Maybe the right time to move to XML is when an author or WG is ready to submit to IESG.

That's exactly where kramdown fits in. There will be an XML file, but it is automatically generated and you never need to look inside it. I'm no expert, I've only done a handful of drafts in kramdown, but it's clearly more approachable than raw XML, or even nroff.

(I have to say that there are corner cases where you *do* need to look at the XML, but I think those will get less as time goes on.)

Have you tried authoring in an ACM or IEEE format recently? They are *seriously* harder to satisfy than the IETF, even if you are experienced in using LaTeX.

Regards
     Brian