Re: [rfc-i] Updates to RFC XML

Robert Sparks <rjsparks@nostrum.com> Tue, 10 May 2022 02:45 UTC

Return-Path: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id 31F70C15E6C4 for <ietfarch-rfc-interest-archive@ietfa.amsl.com>; Mon, 9 May 2022 19:45:35 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1652150735; bh=6Yb+sO8uhjcL0b85YGH9uHdahn28FFlpd3BIkRFjHWE=; h=Date:To:References:From:In-Reply-To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe; b=LU3GNr6408mKod6HtBYL969Avmhgi72ib8SjWeF8Eco/YtS/uryoUXgPRQRqxGVX7 sEhhu2TJiLBQk4aNtKWtMoBqsoFJFO1bu+Iv0b3Isb4FS5hB7OllaiKCQT7J3j+RPI ZbnveTGFsRBy2eL0Mp/e02NHiy17OGSG0VR66C44=
X-Mailbox-Line: From rfc-interest-bounces@rfc-editor.org Mon May 9 19:45:35 2022
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id 0B268C15E3E6; Mon, 9 May 2022 19:45:35 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1652150735; bh=6Yb+sO8uhjcL0b85YGH9uHdahn28FFlpd3BIkRFjHWE=; h=Date:To:References:From:In-Reply-To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe; b=LU3GNr6408mKod6HtBYL969Avmhgi72ib8SjWeF8Eco/YtS/uryoUXgPRQRqxGVX7 sEhhu2TJiLBQk4aNtKWtMoBqsoFJFO1bu+Iv0b3Isb4FS5hB7OllaiKCQT7J3j+RPI ZbnveTGFsRBy2eL0Mp/e02NHiy17OGSG0VR66C44=
X-Original-To: rfc-interest@ietfa.amsl.com
Delivered-To: rfc-interest@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 1683CC15E3E6 for <rfc-interest@ietfa.amsl.com>; Mon, 9 May 2022 19:45:34 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -8.933
X-Spam-Level:
X-Spam-Status: No, score=-8.933 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, NICE_REPLY_A=-1.857, RCVD_IN_DNSWL_HI=-5, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nostrum.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 T7iJNYZIyLrJ for <rfc-interest@ietfa.amsl.com>; Mon, 9 May 2022 19:45:30 -0700 (PDT)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 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 02A31C14F735 for <rfc-interest@rfc-editor.org>; Mon, 9 May 2022 19:45:29 -0700 (PDT)
Received: from [192.168.1.114] ([47.186.48.51]) (authenticated bits=0) by nostrum.com (8.17.1/8.16.1) with ESMTPSA id 24A2jRBN097898 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO) for <rfc-interest@rfc-editor.org>; Mon, 9 May 2022 21:45:28 -0500 (CDT) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1652150728; bh=2QCGWaPsZh1mE2J986xMZ5icVcK4I2jy4IpC2eWwf4c=; h=Date:Subject:To:References:From:In-Reply-To; b=wG3ug0HQLD8vKUX9PSlWlxHueyd4nSFDPZpTyXDTawsufNNqyonOf29mJAGH2Q1O+ eYemvqAwXm/rhtNN0TAUVOw7l+HPBotCkj2MnFgpYXb4gWwrc/jZfiX/CKwTg59wB0 +hrZlWDwReEAKQq+5YqYrarDz3Jumfc0HZ3TVYWE=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.48.51] claimed to be [192.168.1.114]
Message-ID: <8df928c2-727e-e870-e7ab-99a0339c3f81@nostrum.com>
Date: Mon, 09 May 2022 21:45:22 -0500
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.9.0
Content-Language: en-US
To: rfc-interest@rfc-editor.org
References: <20220509214746.E11AE3FAEBA7@ary.qy>
From: Robert Sparks <rjsparks@nostrum.com>
In-Reply-To: <20220509214746.E11AE3FAEBA7@ary.qy>
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-interest/FPCmUb27ofpRIGwaSgTyZ-krCP0>
Subject: Re: [rfc-i] Updates to RFC XML
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://mailman.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Content-Transfer-Encoding: base64
Content-Type: text/plain; charset="utf-8"; Format="flowed"
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

On 5/9/22 4:47 PM, John Levine wrote:
> It appears that Julian Reschke  <julian.reschke@gmx.de> said:
>>> In the <rfc> element, make the docName attribute the name of the RFC,
>>> e.g., "rfc9999" rather than the draft it used to be.  The draft name is
>>> available in a <link> element.
>> I would prefer to restore the number attribute defined in 7749 (and the
>> sibling attributes).
> I gather that means you can have docName or number but not both?  I wouldn't
> be opposed to that but I don't know what that would break.  Also, which
> sibling attributes?
I would prefer a future where all documents in this grammar have a name 
in one place that can be simply retrieved, not one that requires a bunch 
of conditional logic to compute.
>
>>> Remove the generated <toc> element in prepped XML.  It's not used when
>>> rendering the document (xml2rfc scans the section headers), takes up
>>> space, and is confusing.  The TOC in rendered text, HTML, and PDF would
>>> be unaffected.
>> Absolutely. And please remove related atrocities, like <author> as child
>> element of <section>.
> Do any published RFCs have <author> in <section>?  I'm trying to limit this
> to changes we can do mechanically so we don't have to hand edit and proofread
> a thousand documents again.  I suppose I could check easily enough but you
> can probably write the xslt faster than I can write the python.
>
> R's,
> John
>
> _______________________________________________
> rfc-interest mailing list
> rfc-interest@rfc-editor.org
> https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest

_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest