Re: Call for review of proposed update to ID-Checklist
Dave Crocker <dhc2@dcrocker.net> Sun, 10 August 2008 16:14 UTC
Return-Path: <ietf-bounces@ietf.org>
X-Original-To: ietf-archive@megatron.ietf.org
Delivered-To: ietfarch-ietf-archive@core3.amsl.com
Received: from [127.0.0.1] (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id B595C28C19F; Sun, 10 Aug 2008 09:14:50 -0700 (PDT)
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 8DBC33A6B05; Sun, 10 Aug 2008 09:14:49 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.227
X-Spam-Level:
X-Spam-Status: No, score=-2.227 tagged_above=-999 required=5 tests=[AWL=0.372, 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 Gy6ebS5PsFpv; Sun, 10 Aug 2008 09:14:48 -0700 (PDT)
Received: from sbh17.songbird.com (mail.mipassoc.org [IPv6:2001:470:1:76:0:ffff:4834:7146]) by core3.amsl.com (Postfix) with ESMTP id 3C2B23A6DDD; Sun, 10 Aug 2008 09:14:47 -0700 (PDT)
Received: from [192.168.0.3] (adsl-67-127-53-187.dsl.pltn13.pacbell.net [67.127.53.187]) (authenticated bits=0) by sbh17.songbird.com (8.13.8/8.13.8) with ESMTP id m7AGEiAe015209 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 10 Aug 2008 09:14:45 -0700
Message-ID: <489F13F2.3060707@dcrocker.net>
Date: Sun, 10 Aug 2008 09:14:42 -0700
From: Dave Crocker <dhc2@dcrocker.net>
Organization: Brandenburg InternetWorking
User-Agent: Thunderbird 2.0.0.16 (Windows/20080708)
MIME-Version: 1.0
To: "Bert Wijnen (IETF)" <bertietf@bwijnen.net>
Subject: Re: Call for review of proposed update to ID-Checklist
References: <D78EAB64AF674E24B2199B2C1DBDA1FE@BertLaptop>
In-Reply-To: <D78EAB64AF674E24B2199B2C1DBDA1FE@BertLaptop>
X-Virus-Scanned: ClamAV 0.92/7999/Sun Aug 10 04:05:47 2008 on sbh17.songbird.com
X-Virus-Status: Clean
X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0 (sbh17.songbird.com [72.52.113.17]); Sun, 10 Aug 2008 09:14:45 -0700 (PDT)
Cc: iesg@ietf.org, ietf@ietf.org
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
Reply-To: dcrocker@bbiw.net
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
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>
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="us-ascii"; Format="flowed"
Sender: ietf-bounces@ietf.org
Errors-To: ietf-bounces@ietf.org
Bert, Bert Wijnen (IETF) wrote: > As you all can see, the ID-Checklist in fact DOES refer to the rfc2223bis at > many places. Yes, but... 1. draft-rfc-editor-rfc2223bis is expired. 2. While the citations that are included mostly do include the specific section to look in, some do not. (See the first example, below.) Hence, some of the citations are too broad. 3. Much of the document's direction is offered without citation. From the July 4 <http://www.ietf.org/ID-Checklist.html>... > 2.2. Required sections - all I-Ds ... > List of authors/editors > > There should not be more than 5 authors/editors (see > http://www.rfc-editor.org/policy.html) The Policy document is about 10 pages long. I thought the specific information would be in "Authors vs. Contributors" but it wasn't. One has to search awhile to find Item #1 under an interestingly named section "Author Overload", to find the basis for the "should" in the checklist. And note that the normative "should" language in the Checklist, here, might be considered stronger than what is actually said in the RFC Editor's policy document. (One can debate this, but then, that debate is exactly what we ought to have, based on hard data like this. My own opinion is that the "should" is appropriate here, in terms of actual practice, and it's long been what I advise folk writing drafts.) > 1. Introduction ... > As a suggestion for productivity improvement, it is strongly RECOMMENDED to > use XML2RFC The capitalization appears intended to offer essentially normative guidance but, of course, that's probably not what is meant. > 2.2. Required sections - all I-Ds > > The following are REQUIRED sections in all Internet-Drafts: What is the basis for asserting that this list is *required* (and, by the way, is "required" meant as a normative term; the caps suggest yes)? Again, please note that I'm not claiming the list is wrong, but that its provenance is absent. So your view that "Our processes are described in formally approved BCP documents" might be at risk. > 3. Content issues ... > B. no citations While I happen to think this is quite good advice, I have no idea a) where it comes from, or b) whether it is guidance or requirement. The one before it, "Should be meaningful to someone not versed in the technology" also lacks basis. Further, as guidance, it's reasonable, but entirely lacking in substance to help an author know how to satisfy it. and also from that section: > Specific IPR (e.g., patent claims & terms) must not be in an RFC The "must" is interesting. What BCP documents this (entirely reasonable, IMO) requirement? And so on. d/ -- Dave Crocker Brandenburg InternetWorking bbiw.net _______________________________________________ Ietf mailing list Ietf@ietf.org https://www.ietf.org/mailman/listinfo/ietf
- Re: Call for review of proposed update to ID-Chec… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Pete Resnick
- Call for review of proposed update to ID-Checklist IETF Chair
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… Pete Resnick
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- RE: Call for review of proposed update to ID-Chec… Bert Wijnen - IETF
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- RE: Call for review of proposed update to ID-Chec… Bert Wijnen - IETF
- RE: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Theodore Tso
- Re: Call for review of proposed update to ID-Chec… Brian E Carpenter
- Re: Call for review of proposed update to ID-Chec… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Thomas Narten
- Re: Call for review of proposed update to ID-Chec… Spencer Dawkins
- Re: Call for review of proposed update to ID-Chec… Bill McQuillan
- Re: Call for review of proposed update to ID-Chec… Paul Hoffman
- Re: Call for review of proposed update to ID-Chec… Spencer Dawkins
- More example TLDs in 2606bis? (was: Call for revi… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Keith Moore
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Ted Hardie
- Re: Call for review of proposed update to ID-Chec… Keith Moore
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Bob Braden
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Eliot Lear
- Re: Call for review of proposed update to ID-Chec… Keith Moore
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Paul Hoffman
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… Julian Reschke
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Henrik Levkowetz
- Re: Call for review of proposed update to ID-Chec… Brian E Carpenter
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… John C Klensin
- Re: Call for review of proposed update to ID-Chec… Julian Reschke
- Re: Call for review of proposed update to ID-Chec… Lars Eggert
- Re: Call for review of proposed update to ID-Chec… Henrik Levkowetz
- ID desires and TOOLS stuff [was: Re: Call for rev… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Julian Reschke
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… Henrik Levkowetz
- Re: Call for review of proposed update to ID-Chec… SM
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Mixed case (was: Call for review of proposed upda… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Russ Housley
- Re: Call for review of proposed update to ID-Chec… Frank Ellermann
- Re: Call for review of proposed update to ID-Chec… Harald Alvestrand
- Re: Call for review of proposed update to ID-Chec… Bert Wijnen (IETF)
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… Dave Crocker
- Re: Call for review of proposed update to ID-Chec… Spencer Dawkins
- Re: Call for review of proposed update to ID-Chec… Robert Elz