[Xml-sg-cmt] QUIC docs - Fwd: [C430] Process we're following for AUTH48

Sandy Ginoza <sginoza@amsl.com> Mon, 03 May 2021 17:08 UTC

Return-Path: <sginoza@amsl.com>
X-Original-To: xml-sg-cmt@ietfa.amsl.com
Delivered-To: xml-sg-cmt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 392EB3A1C9E for <xml-sg-cmt@ietfa.amsl.com>; Mon, 3 May 2021 10:08:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.198
X-Spam-Level:
X-Spam-Status: No, score=-4.198 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_MED=-2.3, 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 yCOX_EXl8VPa for <xml-sg-cmt@ietfa.amsl.com>; Mon, 3 May 2021 10:08:20 -0700 (PDT)
Received: from mail.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 18BBF3A1C96 for <xml-sg-cmt@ietf.org>; Mon, 3 May 2021 10:08:20 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id 002BB38B4D4 for <xml-sg-cmt@ietf.org>; Mon, 3 May 2021 10:08:20 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from c8a.amsl.com ([127.0.0.1]) by localhost (c8a.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id NNtcFyJIfwFE for <xml-sg-cmt@ietf.org>; Mon, 3 May 2021 10:08:19 -0700 (PDT)
Received: from [192.168.1.175] (cpe-172-113-155-155.socal.res.rr.com [172.113.155.155]) by c8a.amsl.com (Postfix) with ESMTPSA id BF11D38B4BE for <xml-sg-cmt@ietf.org>; Mon, 3 May 2021 10:08:19 -0700 (PDT)
From: Sandy Ginoza <sginoza@amsl.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_1BDF5826-0502-4D1A-9FC9-9D8E98A618D6"
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
Message-Id: <5F20AEC3-A97C-458E-A59F-0D7B5FD43257@amsl.com>
References: <4b8436e0-8318-4741-9042-05018e0a0ecc@www.fastmail.com>
To: XML weed whackers <xml-sg-cmt@ietf.org>
Date: Mon, 03 May 2021 10:08:17 -0700
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/-nRXjGs8gkOIYNIeZ5mIZHZfyo4>
Subject: [Xml-sg-cmt] QUIC docs - Fwd: [C430] Process we're following for AUTH48
X-BeenThere: xml-sg-cmt@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Working list for the xml and style guide change management team <xml-sg-cmt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml-sg-cmt/>
List-Post: <mailto:xml-sg-cmt@ietf.org>
List-Help: <mailto:xml-sg-cmt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 03 May 2021 17:08:24 -0000

Hi Peter,

This is the original mail from Martin where he outlines the process they’re using for AUTH48.  I forgot about this and was totally off base regarding “run by reviewers.”  

> We have decided to port the changes proposed by the RPC back to our source documents.  This will give us the opportunity to use our existing processes for reviewing all of the changes.


Sandy 

> Begin forwarded message:
> 
> From: Martin Thomson via C430 <c430@rfc-editor.org>
> Subject: [C430] Process we're following for AUTH48
> Date: April 27, 2021 at 10:11:43 PM PDT
> To: c430@rfc-editor.org
> 
> I just wanted to provide an update regarding the process the editor team is planning to use for AUTH48.
> 
> We have decided to port the changes proposed by the RPC back to our source documents.  This will give us the opportunity to use our existing processes for reviewing all of the changes.
> 
> Once we have completed that process, we will provide new XML files.
> 
> This leaves a few gaps, as we don't author directly in XML.  We'll need to work through the non-textual changes and work out how to manage those.  So far, I've only identified a few things that might be challenging:
> 
> 1. The addition of <bcp14> elements around "MUST" and friends.  I've implemented a tool that can add those automatically (this tool is XML-aware, unlike that provided by Joe Touch, so I trust it more). [*]
> 
> 2. The RPC propose removing <t> elements that are singular children of <dd> elements.  This is awkward and will likely need a process to resolve.
> 
> 3. References.  The way that the RPC manage these is completely different from our existing process.  Right now I'm thinking that we just take the proposed changes for that section of the XML and manually drop that in as needed.  There are only a few changes in references that we might be able to integrate into the source, so we might be able to avoid any manual processing.  That would mean that the XML we produce is different, but it should produce identical results after the preptool runs.
> 
> No doubt we'll find other issues, but this is what I've observed thus far.
> 
> There is one change across the cluster that I wanted to note.  The RPC proposes to cite the various QUIC drafts using "[RFC9000]" throughout.  Our preference would be to retain the existing labels like "[QUIC-TRANSPORT]" and so forth.  That's more text, but we have found that the labels are easier to manage than numbers.
> 
> [*] I wanted to re-raise the following issue with xml2rfc here: https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/548 The invalid XML that is produced by xml2rfc is blocking me from using this tool, largely because of the non-breaking whitespace in the boilerplate inserted by kramdown-rfc2629.  Right now, I'm planning on inserting the boilerplate without the non-breaking whitespace, but I wanted to note that the "&nbsp;" in the XML files we're reviewing is broken as a result and will need to be fixed.
> -- 
> C430 mailing list
> C430@rfc-editor.org
> https://www.rfc-editor.org/mailman/listinfo/c430
>