Re: RFC abbreviations list

Carsten Bormann <cabo@tzi.org> Sun, 26 July 2020 05:52 UTC

Return-Path: <cabo@tzi.org>
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 AEE493A0B4D for <ietf@ietfa.amsl.com>; Sat, 25 Jul 2020 22:52:25 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.92
X-Spam-Level:
X-Spam-Status: No, score=-1.92 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-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 Tl-9E4SUrfMf for <ietf@ietfa.amsl.com>; Sat, 25 Jul 2020 22:52:19 -0700 (PDT)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de [134.102.50.17]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A3C293A0B4E for <ietf@ietf.org>; Sat, 25 Jul 2020 22:52:18 -0700 (PDT)
Received: from [192.168.217.116] (p5089ae91.dip0.t-ipconnect.de [80.137.174.145]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-vm-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4BDsXH0fwzzyXQ; Sun, 26 Jul 2020 07:52:15 +0200 (CEST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\))
Subject: Re: RFC abbreviations list
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <e6d6a42c-e085-e8a1-7c3e-5f7614e3d442@joelhalpern.com>
Date: Sun, 26 Jul 2020 07:52:14 +0200
Cc: IETF list <ietf@ietf.org>
X-Mao-Original-Outgoing-Id: 617435534.282958-c351b7946b2851fa131da37903979a1b
Content-Transfer-Encoding: quoted-printable
Message-Id: <75C124C8-059F-4A25-8EE7-129241B4A7C7@tzi.org>
References: <35BE966B-63A2-438F-BD61-570E86ED2E1A@strayalpha.com> <297BF899-553D-44DB-AB56-04280F776F7A@employees.org> <6646575A-E6EA-4B4E-AC1B-F8B84B5A1203@strayalpha.com> <20200724225654.GB43465@faui48f.informatik.uni-erlangen.de> <8F6D2B44-1914-4B3B-9458-3F2BF2CFCA05@tzi.org> <20200725210457.GJ43465@faui48f.informatik.uni-erlangen.de> <9A6BE775-78B9-41C5-A3EE-A34C7D092CA0@tzi.org> <20200725221507.GL43465@faui48f.informatik.uni-erlangen.de> <b8163085-e988-ae6a-e93f-3702f33b0dd0@joelhalpern.com> <20200725225731.GP43465@faui48f.informatik.uni-erlangen.de> <CEA49C2751557DF4896FE6B2@PSB> <DD1FEBD3-4488-419E-A3E7-DC95FABB7F65@tzi.org> <e6d6a42c-e085-e8a1-7c3e-5f7614e3d442@joelhalpern.com>
To: "Joel M. Halpern" <jmh@joelhalpern.com>
X-Mailer: Apple Mail (2.3608.120.23.2.1)
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/31jXFRVkddZbf6cZ0RCRUsAz5xk>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
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: <https://mailarchive.ietf.org/arch/browse/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: Sun, 26 Jul 2020 05:52:27 -0000

What I was trying to say was that the bar:

> that
> the abbreviation be well-known and immediately obvious to anyone
> with a significant Internet technical or operational background
> and experience.  

… for getting starred is too high.  RSASSA-PSS is also an example how the “starred” list doesn’t really work that well (the RFC title doesn’t expand it although it is not starred), as are many other cases.

So the putative criteria is wrong, (partially as a result of that, and partially because the whole concept doesn’t quite work) the list is applied inconsistently, and it seems that there is no uniformity in the result.

Looks like something that needs work.

Maybe not urgently, but it is one of those pieces of technical debt that come up each time an RFC is published, the main damage being that their titles are often mangled beyond recognition, which makes them harder, not easier, to understand.

Giving some regular attention (*) to that list could ease the pain, which is what I was trying to point out.  
In the end we’ll also need a better policy to handle the expansion issue.

Maybe all stuff to do for the RSE-ng, but stuff to do it is.

Grüße, Carsten

(*) Randomly poking:

6CIO       - 6LoWPAN Capability Indication (6CIO) 
6CO        - 6LoWPAN Context Option (6CO)

(Both should say “Option”)

ARMv4     *- Advanced RISC Machine version 4 

(This surely shouldn’t be starred under the criteria above, but then it also doesn’t make sense to expand it.  It is used in a single RFC, 6366, in an example.  This is a mid-1990s technology...)

Because the > 2500 lines are in no way sourced or even dated, it does not lend itself to divvying up the work to clean this up.  Maybe some mining in the RFCs can help do that, e.g. assigning IETF areas to the abbrevs.  But we need to understand how this list is being used, how the list could be improved to help these use cases, and what the appropriate criteria might be for them.