Re: RFC Errata: when to file, and when not to

t.p. <daedulus@btconnect.com> Thu, 09 August 2012 08:12 UTC

Return-Path: <daedulus@btconnect.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 25CA521F86E4 for <ietf@ietfa.amsl.com>; Thu, 9 Aug 2012 01:12:33 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.54
X-Spam-Level:
X-Spam-Status: No, score=-3.54 tagged_above=-999 required=5 tests=[AWL=0.059, BAYES_00=-2.599, RCVD_IN_DNSWL_LOW=-1]
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 8ljT0gHOuxwy for <ietf@ietfa.amsl.com>; Thu, 9 Aug 2012 01:12:32 -0700 (PDT)
Received: from db3outboundpool.messaging.microsoft.com (db3ehsobe002.messaging.microsoft.com [213.199.154.140]) by ietfa.amsl.com (Postfix) with ESMTP id 03EEE21F873B for <ietf@ietf.org>; Thu, 9 Aug 2012 01:12:31 -0700 (PDT)
Received: from mail17-db3-R.bigfish.com (10.3.81.233) by DB3EHSOBE010.bigfish.com (10.3.84.30) with Microsoft SMTP Server id 14.1.225.23; Thu, 9 Aug 2012 08:12:30 +0000
Received: from mail17-db3 (localhost [127.0.0.1]) by mail17-db3-R.bigfish.com (Postfix) with ESMTP id CAD5A1C0076; Thu, 9 Aug 2012 08:12:30 +0000 (UTC)
X-Forefront-Antispam-Report: CIP:157.55.224.141; KIP:(null); UIP:(null); IPV:NLI; H:DB3PRD0702HT007.eurprd07.prod.outlook.com; RD:none; EFVD:NLI
X-SpamScore: -24
X-BigFish: PS-24(zz98dI9371I542M1432Izz1202hzz1033IL8275bh8275dhz2dh2a8h5a9h668h839hd24hf0ah107ah304l)
Received: from mail17-db3 (localhost.localdomain [127.0.0.1]) by mail17-db3 (MessageSwitch) id 1344499949609367_26182; Thu, 9 Aug 2012 08:12:29 +0000 (UTC)
Received: from DB3EHSMHS013.bigfish.com (unknown [10.3.81.238]) by mail17-db3.bigfish.com (Postfix) with ESMTP id 88BEC1800B4; Thu, 9 Aug 2012 08:12:29 +0000 (UTC)
Received: from DB3PRD0702HT007.eurprd07.prod.outlook.com (157.55.224.141) by DB3EHSMHS013.bigfish.com (10.3.87.113) with Microsoft SMTP Server (TLS) id 14.1.225.23; Thu, 9 Aug 2012 08:12:29 +0000
Received: from AMSPRD0510HT001.eurprd05.prod.outlook.com (157.56.248.53) by pod51017.outlook.com (10.3.4.168) with Microsoft SMTP Server (TLS) id 14.15.108.4; Thu, 9 Aug 2012 08:12:28 +0000
Message-ID: <006701cd7606$17ff48a0$4001a8c0@gateway.2wire.net>
From: "t.p." <daedulus@btconnect.com>
To: Alessandro Vesely <vesely@tana.it>, ietf@ietf.org
References: <CALaySJKV96tdXhzfPD1e1Mro_+gp5aDarF7Z06QrA+iQtnHkLw@mail.gmail.com><501A5656.2050407@it.aoyama.ac.jp><501BEC0D.1060404@tana.it><009101cd7476$bb522c20$4001a8c0@gateway.2wire.net><599B1629-543A-49BC-A0E7-FA2096C538AD@checkpoint.com><03e701cd749f$73891c40$4001a8c0@gateway.2wire.net> <50229D32.8000605@tana.it>
Subject: Re: RFC Errata: when to file, and when not to
Date: Thu, 09 Aug 2012 09:07:54 +0100
MIME-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2800.1106
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106
X-Originating-IP: [157.56.248.53]
X-OriginatorOrg: btconnect.com
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/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: Thu, 09 Aug 2012 08:12:33 -0000

----- Original Message -----
From: "Alessandro Vesely" <vesely@tana.it>
To: <ietf@ietf.org>
Sent: Wednesday, August 08, 2012 6:09 PM
> On Tue 07/Aug/2012 15:20:35 +0200 t.p. wrote:
> > From: "Yoav Nir" <ynir@checkpoint.com>
> >
> >> Would it make it easier to find if they were called "notes" or
> >> "corrections" instead of "errata"?
> >
> > Yes, corrections is what I see published in a newspaper to correct
> > errata in previous editions.  So far, it is the best word I can
> > think of (but there might be a better one:-).
>
> Errata is an abbreviation of "errata corrige", the Latin for "error
> correction".  Switching to the English translation would seem to be
> consistent with English being the official publication language for
RFCs.
>
> > In the html version of an RFC, it would be easy to provide old and
new
> > in an easy to compare format (as some editors do for I-D), not
perhaps
> > on permanent display but shown when 'errata' (or whatever name we
> > choose) is toggled.
>
> Although easy, doing that would require a noticeable amount of
> editorial work.  In addition, notes, reasons, and explanations don't
> have an obvious graphical rendition.  IMHO, knowing when and why an
> errata was proposed and verified is an integral part of it.

Well, start simple and build on it, something the tools team have a
history of doing:-)

First, have only the one highlighted 'corrections made' field on the
html page.

Second, add a new link to a 'corrections help' page telling the viewer
that once issued, a RFC is never changed, that any changes require a
fresh RFC that updates or supersedes the original one (pointing to the
highlighted fields in the top right hand example, perhaps with a worked
example - but not SMTP:-( but that there is an 'erratum' mechanism for
correcting editorial errors or places where the text is or may not be
clear about the intentions of the editors; and that such errata can be
viewed by clicking on the 'corrections made' field.

Finally, change the 'corrections made' to a 'hide corrections/view
corrections' toggle, default the first setting, the second setting
showing OLD/NEW text, old recognisably different eg struck through, with
a link to the RFC Editor page for the erratum; this is only done for
errata that are accepted.  Yes, there would be some intricate errata
that this would not cover, but the screens you get currently by
following the link to the RFC Editor page are so arcane as to switch off
all but those intimately involved in this standards process.

Tom Petch