Re: [apps-discuss] Requirement for "obsoletes" in Abstracts (was: Re: I-D Action: draft-ietf-appsawg-media-type-regs-00.txt)

Ned Freed <ned.freed@mrochek.com> Sat, 04 February 2012 16:02 UTC

Return-Path: <ned.freed@mrochek.com>
X-Original-To: apps-discuss@ietfa.amsl.com
Delivered-To: apps-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2438F21F8497 for <apps-discuss@ietfa.amsl.com>; Sat, 4 Feb 2012 08:02:41 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.569
X-Spam-Level:
X-Spam-Status: No, score=-2.569 tagged_above=-999 required=5 tests=[AWL=0.030, BAYES_00=-2.599]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id U7E75mIRh+mN for <apps-discuss@ietfa.amsl.com>; Sat, 4 Feb 2012 08:02:40 -0800 (PST)
Received: from mauve.mrochek.com (mauve.mrochek.com [66.59.230.40]) by ietfa.amsl.com (Postfix) with ESMTP id 1921F21F8480 for <apps-discuss@ietf.org>; Sat, 4 Feb 2012 08:02:40 -0800 (PST)
Received: from dkim-sign.mauve.mrochek.com by mauve.mrochek.com (PMDF V6.1-1 #35243) id <01OBL2XV4SYO002PCO@mauve.mrochek.com> for apps-discuss@ietf.org; Sat, 4 Feb 2012 08:02:34 -0800 (PST)
Received: from mauve.mrochek.com by mauve.mrochek.com (PMDF V6.1-1 #35243) id <01OBHM72OXPS00ZUIL@mauve.mrochek.com>; Sat, 4 Feb 2012 08:02:30 -0800 (PST)
Message-id: <01OBL2XS986200ZUIL@mauve.mrochek.com>
Date: Sat, 04 Feb 2012 07:59:47 -0800
From: Ned Freed <ned.freed@mrochek.com>
In-reply-to: "Your message dated Sat, 04 Feb 2012 09:05:05 -0500" <E63757FF71CD8B382B3832E7@PST.JCK.COM>
MIME-version: 1.0
Content-type: TEXT/PLAIN
References: <20120204001408.16716.94710.idtracker@ietfa.amsl.com> <CADBvc9_W9Jaca1TmV5QjyXupLVyLJh=6+334p-HM5pB=aKn15w@mail.gmail.com> <01OBKKTPYLIE00ZUIL@mauve.mrochek.com> <E63757FF71CD8B382B3832E7@PST.JCK.COM>
To: John C Klensin <john-ietf@jck.com>
Cc: Ned Freed <ned.freed@mrochek.com>, apps-discuss@ietf.org
Subject: Re: [apps-discuss] Requirement for "obsoletes" in Abstracts (was: Re: I-D Action: draft-ietf-appsawg-media-type-regs-00.txt)
X-BeenThere: apps-discuss@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: General discussion of application-layer protocols <apps-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/apps-discuss>
List-Post: <mailto:apps-discuss@ietf.org>
List-Help: <mailto:apps-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 04 Feb 2012 16:02:41 -0000

Initial response: *gulp*

I obviously don't feel nearly as strongly about this as John does, although I
completely agree with everything he says. So I'm going to defer to him entirely
on this point. I won't add anything to the document at the present time and
we'll see how it goes.

And with that, I actually think it's time to post -01. It should be out
in a few minutes.

				Ned

> --On Friday, February 03, 2012 22:52 -0800 Ned Freed
> <ned.freed@mrochek.com> wrote:

> >...
> >> In Abstract, it must be mentioned that the document obsoletes
> >> RFC 4288.
> >
> > A stupid rule in my opinion, but a rule nevertheless. I forgot
> > to add it but will do so in the next revision.

> Actually, as co-author, I want to strongly resist this change
> and therefore that putative rule (I claim that, independent of
> its substantive properties, it is invalid; see below).   I have
> three separate reasons, any one of which would, IMO, justify
> saying "no".

> Rant follows.

> (1) Abstracts are supposed to be about the content and function
> of the document and are supposed to be as minimal as possible
> while still covering the actual substance.  Except in unusual
> cases, which this is not, mentioning the history and
> relationships of a document in the Abstract is not substantively
> important to someone who is simply looking at it to find the
> present state of things, as would be the case with this once it
> is published.   Worse, except for RFCs that are much better
> known by their numbers than by their titles (there aren't many;
> RFC 822 comes to mind as an example), good practice requires
> citations on first use to explain what the number refers to.
> But the RFC Editor's practice (and almost every style manual for
> professional publications in the world) prohibits citations from
> Abstracts -- they are supposed to stand on their own. Things
> might be different if the sole purpose of a document were to
> obsolete or reclassify another one, but that does not apply in
> this case.

> That may be a very long way of saying "stupid rule".

> (2) Determination of what should be required or permitted in
> Abstracts in published RFCs has always been an RFC Editor
> matter, not something the IESG can change, any more than they
> can unilaterally change page header or footer formats.  Note
> that we already have a header on the first page (almost always
> the same pages as the abstract since we fixed the "boilerplate
> first" problem), so, stylistically, there is a "how much
> overkill is needed" question.  FWIW, I don't have any problem
> with the IESG imposing an "explain what this updates and why"
> requirement on the body of a document, although I believe even
> then that they ought to have a discussion with the RFC Editor
> about placement (e.g., Introduction versus separate section or
> subsection).

> I believe that the "Status of Document" section of IETF Stream
> RFCs basically belongs to the IETF and IESG, so, if the IESG
> wants some particular "obsoletes XXX" text there, I might still
> think it was stupid, but I wouldn't consider it nearly as
> inappropriate as imposing requirements on the abstract.   In
> addition, I think the IESG, subject to community review, can
> impose whatever requirements they think necessary on I-Ds to get
> effective review of documents.  I think the rule requiring that
> all IETF Stream I-Ds contain an "IANA Considerations" section
> that can be removed on publication is ill-advised and have seen
> a number of problems that can be attributed to the rule itself.
> But, if the IESG, after careful deliberation, is convinced that
> it is helpful to the review and consensus process, I'm ok with
> it and will conform without saying much of anything.   The same
> principle might apply here: if the IESG wants to say, e.g., that
> obsoleting or reclassification relationships should be reflected
> in an extra paragraph of the Abstract that is removed on
> publication and hence not subject to the RFC Editor's rules
> about length and content, I'll mutter into my beard, but will
> comply.

> (3) Although they can make suggestions and determine their own
> practices, the IESG doesn't get to invent and make binding rules
> for the community.  The Tools Team may incorporate what they
> consider reasonable practices into checking tools (I'm strongly
> in favor of that, actually), but that doesn't make those
> practices binding on the community either.  In both cases, the
> difference between "strong suggestion" and "requirement" has
> always been community consensus.  That hasn't occurred here --
> there has been no document for which community discussion has
> occurred and consensus sought.  What we have is

>  (i) a statement in Section 3(1)(D) of the I-D checklist
> 	http://www.ietf.org/id-info/checklist.html (a fine
> 	document if taken as strong suggestions)
>  (ii) a check in the the I-D nits tool.
>  (iii) a few statements, e.g., in the checklist itself
> 	and the Shepherd template that effectively make the
> 	above normative.

> There has not been an explicit consensus call on this
> requirement in on any of the above contexts.

> In the interest of efficiency, I'm even ok if the IESG sets
> requirements and puts them into effect immediately, issuing
> formal consensus calls only later or if there are objections
> from the community.  Well, I'm objecting, I have objected in the
> past, and, while the the IESG hasn't issued a consensus call,
> they have published Standards Track documents in the IETF Stream
> that do not contain "obsoleting" information in the abstract.

> And, again, even if the IESG asked for community consensus and
> got it, it isn't clear that they can impose requirements on the
> content of abstracts without the concurrence of the RFC Editor.

>    john-the-grump

> _______________________________________________
> apps-discuss mailing list
> apps-discuss@ietf.org
> https://www.ietf.org/mailman/listinfo/apps-discuss