Re: I-D Action:draft-housley-iesg-rfc3932bis-12.txt
Julian Reschke <julian.reschke@gmx.de> Mon, 23 November 2009 12:38 UTC
Return-Path: <julian.reschke@gmx.de>
X-Original-To: ietf@core3.amsl.com
Delivered-To: ietf@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 6C31D3A6A20 for <ietf@core3.amsl.com>; Mon, 23 Nov 2009 04:38:24 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.544
X-Spam-Level:
X-Spam-Status: No, score=-4.544 tagged_above=-999 required=5 tests=[AWL=-1.945, BAYES_00=-2.599]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id U7ozsFtsE3D3 for <ietf@core3.amsl.com>; Mon, 23 Nov 2009 04:38:23 -0800 (PST)
Received: from mail.gmx.net (mail.gmx.net [213.165.64.20]) by core3.amsl.com (Postfix) with SMTP id CF2B33A6858 for <ietf@ietf.org>; Mon, 23 Nov 2009 04:38:22 -0800 (PST)
Received: (qmail invoked by alias); 23 Nov 2009 12:38:17 -0000
Received: from mail.greenbytes.de (EHLO [192.168.1.105]) [217.91.35.233] by mail.gmx.net (mp057) with SMTP; 23 Nov 2009 13:38:17 +0100
X-Authenticated: #1915285
X-Provags-ID: V01U2FsdGVkX1/pTt4DLBbpgmJGgKCkdtvvg1QIqjp4z5C1HjpNJQ SPTP1lviyRuWul
Message-ID: <4B0A8236.2080200@gmx.de>
Date: Mon, 23 Nov 2009 13:38:14 +0100
From: Julian Reschke <julian.reschke@gmx.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; de; rv:1.8.0.4) Gecko/20060516 Thunderbird/1.5.0.4 Mnenhy/0.7.4.666
MIME-Version: 1.0
To: IETF discussion list <ietf@ietf.org>, "rfc-interest@rfc-editor.org" <rfc-interest@rfc-editor.org>, xml2rfc <xml2rfc@lists.xml.resource.org>
Subject: Re: I-D Action:draft-housley-iesg-rfc3932bis-12.txt
References: <20091116230001.C9ECD3A6A36@core3.amsl.com> <4B033930.2040603@gmail.com> <4B037FAF.5060801@gmx.de>
In-Reply-To: <4B037FAF.5060801@gmx.de>
Content-Type: text/plain; charset="ISO-8859-1"; format="flowed"
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-FuHaFi: 0.5
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Nov 2009 12:38:24 -0000
Julian Reschke wrote: > > <http://tools.ietf.org/html/draft-iab-streams-headers-boilerplates-08#section-3.2.3> > says: > > "Information about the current status of this document, any errata, > and how to provide feedback on it may be obtained at > http://www.rfc-editor.org/<static-path>/rfc<rfc-no>.html" > > Can we please recommend *not* to put a file extension into the URL? > > BR, Julian > ... Hi, in the meantime I have finished a prototype implementation of the new boilerplate in rfc2629.xslt (*not* xml2rfc!). The implementation is available from <http://greenbytes.de/tech/webdav/rfc2629xslt.zip>, and requires the use of two new extension Processing Instructions to enable the new boilerplate: <?rfc-ext h-a-b="yes"?> <?rfc-ext consensus="no"?> (where the first enables the new format, while the second provides the information about whether there was consensus, something the current xml2rfc format doesn't provide). I haven't found any problems in addition to what was reported before, except for a trailing dot in one of the boilerplate statements, and cases of repeating sentence beginnings -- maybe all of this can be fixed during AUTH48 (although I'd prefer to see this in a new draft for community review). For the record, here's a complete summary: -- snip -- 3.1. The title page header <document source> This describes the area where the work originates. Historically, all RFCs were labeled Network Working Group. "Network Working Group" refers to the original version of today's IETF when people from the original set of ARPANET sites and whomever else was interested -- the meetings were open -- got together to discuss, design and document proposed protocols [RFC0003]. Here, we obsolete the term "Network Working Group" in order to indicate the originating stream. The <document source> is the name of the RFC stream, as defined in [RFC4844] and its successors. At the time of this publication, the streams, and therefore the possible entries are: * Internet Engineering Task Force * Internet Architecture Board * Internet Research Task Force * Independent JRE: as discussed earlier: should this be "Independent Submission" instead of "Independent"? [<RFC relation>:<RFC number[s]>] Some relations between RFCs in the series are explicitly noted in the RFC header. For example, a new RFC may update one or more earlier RFCs. Currently two relationships are defined: "Updates", and "Obsoletes" [RFC2223]. Variants like "Obsoleted by" are also used (e.g in [RFC5143]). Other types of relationships may be defined by the RFC Editor and may appear in future RFCs. JRE: "Obsoleted By" is not a variant of "Obsoletes" or "Updates". 3.2.2. Paragraph 2 The second paragraph of the "Status of This Memo" will now include a paragraph describing the type of review and exposure the document has received. This is defined on a per-stream basis, subject to general review and oversight by the RFC Editor and IAB. There is a specific structure defined here to ensure there is clarity about review processes and document types. These paragraphs will need to be defined and maintained as part of RFC stream definitions. Initial text, for current streams, is provided below. The paragraph may include some text that is specific to the initial document category, as follows: when a document is Experimental or Historic the second paragraph opens with: Experimental: "This document defines an Experimental Protocol for the Internet community." Historic: "This document defines a Historic Document for the Internet community." JRE: the way paragraph 2 is generated, we end up with instances where the 1st and 2nd sentence both start with "This document". This is ugly. Is it too late to fix this? In addition a sentence indicating the consensus base within the IRTF may be added: "This RFC represents the consensus of the <insert_name> Research Group of the Internet Research Task Force (IRTF)." or alternatively "This RFC represents the individual opinion(s) of one or more members of the <insert_name> Research Group of the Internet Research Task Force (IRTF)". JRE: trailing dot missing in 2nd variant. 3.2.3. Paragraph 3 "Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/<static-path>/rfc<rfc-no>.html" JRE: please do not bake a file extension into the permanent URL (see also <http://www.ietf.org/mail-archive/web/ietf/current/msg59415.html>) -- snip -- Best regards, Julian
- Re: I-D Action:draft-housley-iesg-rfc3932bis-12.t… Brian E Carpenter
- Re: I-D Action:draft-housley-iesg-rfc3932bis-12.t… Julian Reschke
- Re: I-D Action:draft-housley-iesg-rfc3932bis-12.t… Paul Hoffman
- Re: I-D Action:draft-housley-iesg-rfc3932bis-12.t… Julian Reschke
- Important: do not publish "draft-iab-streams-head… Julian Reschke
- Re: I-D Action:draft-housley-iesg-rfc3932bis-12.t… Julian Reschke
- Re: [rfc-i] Important: do not publish "draft-iab-… RFC Editor
- Re: [rfc-i] Important: do not publish "draft-iab-… Julian Reschke
- Re: [rfc-i] Important: do not publish "draft-iab-… Bob Braden
- Re: [rfc-i] Important: do not publish "draft-iab-… Dave CROCKER
- Re: [rfc-i] Important: do not publish "draft-iab-… Julian Reschke
- Re: I-D Action:draft-housley-iesg-rfc3932bis-12.t… Alfred Hönes
- Re: [rfc-i] Important: do not publish "draft-iab-… Alice Hagens
- RE: [rfc-i] Important: do not publish "draft-iab-… Jim Schaad
- Re: [rfc-i] Important: do not publish "draft-iab-… Julian Reschke
- Re: [rfc-i] Important: do not publish "draft-iab-… Julian Reschke
- Re: [rfc-i] Important: do not publish "draft-iab-… Olaf Kolkman
- Re: [rfc-i] Important: do not publish "draft-iab-… Brian E Carpenter
- Re: [rfc-i] Important: do not publish "draft-iab-… Russ Housley
- Re: [rfc-i] Important: do not publish "draft-iab-… Bob Hinden
- Re: [rfc-i] Important: do not publish "draft-iab-… Jari Arkko
- Re: [rfc-i] Important: do not publish "draft-iab-… Olaf Kolkman
- RE: [rfc-i] Important: do not publish "draft-iab-… Jim Schaad